Users

Get user by ID

Returns a single user by their unique identifier. Returns 404 if the user does not exist or does not have a seat assignment in the workspace.

get/users/{id}

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/users/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://oauth.nooks.in/oauth/authorize, token URL https://oauth.nooks.in/oauth/token, scopes: users:read)

Path parameters

idstring required

Unique identifier for the user

Response

Successful response

idstring required

Unique identifier for the user

namestring required

Full name of the user

emailstring email required

Email address of the user

crmIdstring nullable required

The user's id in the customer's CRM of record (e.g. a Salesforce User.Id / OwnerId), resolved via the workspace's CRM user mappings. Null when the user has no CRM mapping.

createdAtstring date-time required

When the user was created

updatedAtstring date-time required

When the user was last updated

Example response

{
  "id": "KKLvN5wQoghWFwUvC75CZ12QM7I3",
  "name": "Jane Doe",
  "email": "jane@example.com",
  "crmId": "0051a000000XyzABC",
  "createdAt": "2025-09-29T22:10:51.271Z",
  "updatedAt": "2025-10-07T20:42:17.281Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.