Sample - Asana API
POST/projects/{project_gid}/addFollowers

Add followers to a project

Adds specified users as followers of a project and returns the updated project record. Provide the users in followers; users who are not already project members also become members as part of this operation.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 1 body field
opt_fieldsarray<string>optional
A comma-separated list of project properties to include in the response, including nested properties such as `current_status.author.name`.

Information about the users to add as project followers.

dataobjectoptional
The request data containing the users to add as followers.

6 status codes
200Returns the updated project record after adding the specified users as followers.
dataobjectoptional
400Returned when a parameter is missing or malformed, or the request syntax is invalid.
errorsarray<object>optional
401Returned when a valid authentication token is not provided.
errorsarray<object>optional
403Returned when the authenticated user cannot access the project or perform the follower change.
errorsarray<object>optional
404Returned when the requested action or project does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the request from completing.
errorsarray<object>optional

Error handling

A 400 is returned when the request is missing or malformed, a 401 when no valid authentication token is provided, and a 403 when access is denied. A 404 is returned when the project or action does not exist, and a 500 indicates a server-side failure. Include the required followers field and use valid user identifiers such as me, an email address, or a user GID.