List users

Retrieves all users who have access to the organization or profile identified by the API key, including their roles and status. Shows invited users (pending acceptance) and active users. Requires developer role or higher.

GET
/v3/users

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v3/users"
{
  "success": true,
  "data": {
    "users": [
      {
        "id": "880e8400-e29b-41d4-a716-446655440003",
        "customer_id": "00000000-0000-0000-0000-000000000000",
        "email": "admin@acme.com",
        "name": "John Admin",
        "role": "admin",
        "status": "active",
        "invited_at": "2026-03-17T16:01:14.6482822+00:00",
        "last_login_at": "2026-09-17T14:01:14.648283+00:00",
        "created_at": "2026-03-17T16:01:14.6482831+00:00",
        "updated_at": "2026-09-16T16:01:14.6482832+00:00"
      },
      {
        "id": "990e8400-e29b-41d4-a716-446655440004",
        "customer_id": "00000000-0000-0000-0000-000000000000",
        "email": "developer@acme.com",
        "name": "Jane Developer",
        "role": "developer",
        "status": "invited",
        "invited_at": "2026-09-15T16:01:14.6482835+00:00",
        "last_login_at": null,
        "created_at": "2026-09-15T16:01:14.6482836+00:00",
        "updated_at": "2026-09-15T16:01:14.6482836+00:00"
      }
    ],
    "pagination": null
  },
  "error": null,
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-17T16:01:14.6482985+00:00",
    "version": "v3"
  }
}
Empty
{
  "success": false,
  "data": null,
  "error": {
    "code": "AUTH_004",
    "message": "You do not have access to this organization or profile",
    "details": null,
    "doc_url": "https://docs.sent.dm/reference/api/authentication"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-17T16:01:14.6483011+00:00",
    "version": "v3"
  }
}
{
  "success": false,
  "data": null,
  "error": {
    "code": "RESOURCE_005",
    "message": "Organization not found",
    "details": null,
    "doc_url": "https://docs.sent.dm/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-17T16:01:14.6483018+00:00",
    "version": "v3"
  }
}
{
  "success": false,
  "data": null,
  "error": {
    "code": "INTERNAL_001",
    "message": "An unexpected error occurred. Please contact support with request ID: req_7X9zKp2jDw",
    "details": null,
    "doc_url": "https://docs.sent.dm/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-17T16:01:14.6483022+00:00",
    "version": "v3"
  }
}

Delete a campaign DELETE

**Deprecated.** This endpoint is replaced by `/v3/sender-profiles` and will be removed in a future release. It still behaves exactly as before, so nothing needs to change today — but new integrations should use `/v3/sender-profiles`, which models a profile's markets, compliance, brand, campaigns and billing explicitly. Deletes a campaign by ID from the brand of the specified profile. The profile must belong to the authenticated organization.

Get user by ID GET

Retrieves detailed information about a specific user in an organization or profile. Requires developer role or higher.