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

Add users to a project

Adds specified users as members of a project and returns the updated project record. Provide the users in members; a user's default notification settings can also add that user as a follower and override the endpoint's default notification behavior.

  • 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 members.

dataobjectoptional
The request data containing the users to add.

6 status codes
200Returns the updated project record after adding the specified users as members.
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 membership 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 members field and use valid user identifiers such as me, an email address, or a user GID.