Users
Get a list of members for an organization.
The organization ID
Limits the number of results to return
10
Pagination token that keeps of track of the current position in the list
Order in which to retrieve the results
false
Search term used to filter organizations by name
List of user IDs.
If set, returns the user that is registered with this email address. Only does exact matching.
GET /organizations/{organizationId}/users HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"results": [
{
"user": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"name": "text",
"bio": "text",
"activeSessions": 1,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z",
"emails": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"email": "[email protected]",
"verified": true,
"passwordSet": true,
"tokenSet": true,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"defaultEmail": "text",
"identities": [
{
"id": "text",
"name": "text",
"email": "text",
"avatarUrl": "text",
"provider": "text",
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"avatarUrl": "text",
"phoneNumber": "text",
"phoneNumbers": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"phoneNumber": "text",
"verified": true,
"primary": true,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"locale": "text",
"timezone": "text",
"badges": [
"messagebird:cx"
],
"userFraudInformation": {
"score": 1,
"userId": "text"
}
},
"status": "banned",
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
]
}
],
"nextPageToken": "text"
}
Add a user to an organization. This can either be an existing user, or a new user that is invited to the platform.
The organization ID
POST /organizations/{organizationId}/users HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 184
{
"userId": "123e4567-e89b-12d3-a456-426614174000",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
]
}
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
Get a single organization membership record.
The organization ID
The user ID
GET /organizations/{organizationId}/users/{userId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"user": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"name": "text",
"bio": "text",
"activeSessions": 1,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z",
"emails": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"email": "[email protected]",
"verified": true,
"passwordSet": true,
"tokenSet": true,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"defaultEmail": "text",
"identities": [
{
"id": "text",
"name": "text",
"email": "text",
"avatarUrl": "text",
"provider": "text",
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"avatarUrl": "text",
"phoneNumber": "text",
"phoneNumbers": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"phoneNumber": "text",
"verified": true,
"primary": true,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"locale": "text",
"timezone": "text",
"badges": [
"messagebird:cx"
],
"userFraudInformation": {
"score": 1,
"userId": "text"
}
},
"status": "banned",
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
],
"teamRoles": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
]
}
]
}
Remove a user from the organization
The organization ID
The user ID
DELETE /organizations/{organizationId}/users/{userId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
No content
Update the properties of the organization membership for the user.
The organization ID
The user ID
Roles to assign to the user.
PATCH /organizations/{organizationId}/users/{userId} HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 168
{
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
],
"attributes": {
"roles": [
"text"
]
}
}
{
"user": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"name": "text",
"bio": "text",
"activeSessions": 1,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z",
"emails": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"email": "[email protected]",
"verified": true,
"passwordSet": true,
"tokenSet": true,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"defaultEmail": "text",
"identities": [
{
"id": "text",
"name": "text",
"email": "text",
"avatarUrl": "text",
"provider": "text",
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"avatarUrl": "text",
"phoneNumber": "text",
"phoneNumbers": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"phoneNumber": "text",
"verified": true,
"primary": true,
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z"
}
],
"locale": "text",
"timezone": "text",
"badges": [
"messagebird:cx"
],
"userFraudInformation": {
"score": 1,
"userId": "text"
}
},
"status": "banned",
"createdAt": "2025-07-05T21:21:55.341Z",
"updatedAt": "2025-07-05T21:21:55.341Z",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
]
}
Last updated
Was this helpful?