Follow a company

PUT 
/users/me/follows/:company_id

Follow the company for the authenticated user — exactly what pressing Follow on its Wefunder page does, side effects included (the company counts the user as a follower and may be notified; the user receives the company's updates). Idempotent: following an already-followed company returns changed: false. 404 for a company the site would not show this user. Requires write:follows, which the user grants explicitly; it is never implied by read:mcp.

Request

Responses

200

The follow state after the call.

401

Authentication required or token is invalid/expired. This error occurs when:

• No Authorization header is provided
• The access token is invalid or malformed
• The access token has expired
• The access token has been revoked

To resolve: Obtain a new access token using the OAuth 2.0 flow.

403

The token does not hold write:follows.

404

Unknown company, or one the site does not show this user.

429

Too many requests in a short time period. The API enforces rate limits to ensure fair usage and system stability. When you exceed the limit, you'll receive this error along with headers indicating when you can retry.

Check the X-RateLimit-Reset header to know when your limit will reset. Consider implementing exponential backoff in your application.

Response Headers

X-RateLimit-Limit

Request limit per hour

X-RateLimit-Remaining

Remaining requests

X-RateLimit-Reset

UTC timestamp when the limit resets