(v2) Create or Edit User

Creates or updates a user account. Provides more control than the v1 user endpoints, including the ability to set the active flag.

To create a new user, set id to -1. To update an existing user, provide their numeric ID.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
person
object
required
Headers
string
required

The current session token. Returned by most API calls and must be passed on all subsequent v2/v3 calls.

string

A unique identifier for your application. Helps Teamworks support staff identify your requests if you need assistance.

Response
200

Returns the saved person object, including the assigned id and an __mtime__ value required for any later update. Date formats: the returned dateOfBirth is in yyyy-MM-dd format. Error semantics: AMS returns HTTP 200 for both success and failure — always inspect the response body rather than relying on the status code.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!