Current user

Make updates to the user to which the login token was issued.

Get profile

get

Retrieve the profile of the currently logged in user.

Authorizations

useraccessKey

AuthorizationstringRequired

Provide the token that is returned upon login

Responses

200

OK

application/json

A user on the platform.

idstring · uuidRequired

ID of the user

statusstring · enumRequired

The status of the user

Default: pendingPossible values:

namestringRequired

The display name for the user

biostringOptional

The user's description

activeSessionsintegerRequired

The number of logged in session for the user.

createdAtstring · date-timeRequired

When the user was created.

updatedAtstring · date-timeRequired

When the user was last updated.

defaultEmailstringOptional

The default email of the user in the list of emails.

avatarUrlstringOptional

URL to the user's profile picture.

phoneNumberone ofOptional

string · phone-numberOptional

or

string · enumOptionalPossible values:

localestring · locale-bcp47Optional

timezonestring · timezoneOptional

The default timezone for the user.

401

unauthorized request

application/json

get

/me

HTTPcURLJavaScriptPython

GET /me HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "name": "text",
  "bio": "text",
  "activeSessions": 1,
  "createdAt": "2026-03-09T18:25:06.980Z",
  "updatedAt": "2026-03-09T18:25:06.980Z",
  "emails": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "email": "[email protected]",
      "verified": true,
      "passwordSet": true,
      "tokenSet": true,
      "createdAt": "2026-03-09T18:25:06.980Z",
      "updatedAt": "2026-03-09T18:25:06.980Z"
    }
  ],
  "defaultEmail": "text",
  "identities": [
    {
      "id": "text",
      "name": "text",
      "email": "text",
      "avatarUrl": "text",
      "provider": "text",
      "createdAt": "2026-03-09T18:25:06.980Z",
      "updatedAt": "2026-03-09T18:25:06.980Z"
    }
  ],
  "avatarUrl": "text",
  "phoneNumber": "text",
  "phoneNumbers": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "phoneNumber": "text",
      "verified": true,
      "primary": true,
      "createdAt": "2026-03-09T18:25:06.980Z",
      "updatedAt": "2026-03-09T18:25:06.980Z"
    }
  ],
  "locale": "text",
  "timezone": "text",
  "badges": [
    "messagebird:cx"
  ],
  "userFraudInformation": {
    "score": 1,
    "userId": "text"
  }
}

Update profile

patch

Update the profile of the currently logged in user.

Authorizations

useraccessKey

AuthorizationstringRequired

Provide the token that is returned upon login

Body

application/json

namestringOptional

The display name for the user

biostringOptional

The user's description

avatarUrlstringOptional

URL to the user's profile picture.

localestring · locale-bcp47Optional

timezonestring · timezoneOptional

The default timezone for the user.

Responses

200

OK

application/json

A user on the platform.

idstring · uuidRequired

ID of the user

statusstring · enumRequired

The status of the user

Default: pendingPossible values:

namestringRequired

The display name for the user

biostringOptional

The user's description

activeSessionsintegerRequired

The number of logged in session for the user.

createdAtstring · date-timeRequired

When the user was created.

updatedAtstring · date-timeRequired

When the user was last updated.

defaultEmailstringOptional

The default email of the user in the list of emails.

avatarUrlstringOptional

URL to the user's profile picture.

phoneNumberone ofOptional

string · phone-numberOptional

or

string · enumOptionalPossible values:

localestring · locale-bcp47Optional

timezonestring · timezoneOptional

The default timezone for the user.

422

Request validation failed

application/json

patch

/me

HTTPcURLJavaScriptPython

PATCH /me HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "name": "text",
  "bio": "text",
  "avatarUrl": "text",
  "locale": "text",
  "timezone": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "name": "text",
  "bio": "text",
  "activeSessions": 1,
  "createdAt": "2026-03-09T18:25:06.980Z",
  "updatedAt": "2026-03-09T18:25:06.980Z",
  "emails": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "email": "[email protected]",
      "verified": true,
      "passwordSet": true,
      "tokenSet": true,
      "createdAt": "2026-03-09T18:25:06.980Z",
      "updatedAt": "2026-03-09T18:25:06.980Z"
    }
  ],
  "defaultEmail": "text",
  "identities": [
    {
      "id": "text",
      "name": "text",
      "email": "text",
      "avatarUrl": "text",
      "provider": "text",
      "createdAt": "2026-03-09T18:25:06.980Z",
      "updatedAt": "2026-03-09T18:25:06.980Z"
    }
  ],
  "avatarUrl": "text",
  "phoneNumber": "text",
  "phoneNumbers": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "phoneNumber": "text",
      "verified": true,
      "primary": true,
      "createdAt": "2026-03-09T18:25:06.980Z",
      "updatedAt": "2026-03-09T18:25:06.980Z"
    }
  ],
  "locale": "text",
  "timezone": "text",
  "badges": [
    "messagebird:cx"
  ],
  "userFraudInformation": {
    "score": 1,
    "userId": "text"
  }
}

Delete profile

delete

Delete the profile of the currently logged in user. Essentially deleting your account with the platform.

Authorizations

useraccessKey

AuthorizationstringRequired

Provide the token that is returned upon login

Responses

202

OK

delete

/me

HTTPcURLJavaScriptPython

DELETE /me HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

202

OK

No content