v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-262621423.8 MB

Create an end-user

Creates an end-user.

post/end-users

Request body

companyNamestring required

The end-user's company name that will be shown elsewhere in Conductor.

sourceIdstring required

The end-user's unique identifier from your system. Maps users between your database and Conductor. Must be unique for each user. If you have only one user, you may use any string value.

emailstring required

The end-user's email address for identification purposes. Setting this field will not cause any emails to be sent.

Example request

{
  "companyName": "Acme Inc.",
  "sourceId": "12345678-abcd-abcd-example-1234567890ab",
  "email": "alice@acme.com"
}

Response

Returns the end-user object after successful end-user creation.

idstring required

The unique identifier for this end-user. You must save this value to your database because it is how you identify which of your users to receive your API requests.

objectType'end_user' required

The type of object. This value is always "end_user".

createdAtstring required

The date and time when this end-user record was created.

companyNamestring required

The end-user's company name that will be shown elsewhere in Conductor.

sourceIdstring required

The end-user's unique identifier from your system. Maps users between your database and Conductor.

emailstring required

The end-user's email address for identification purposes.

Example response

{
  "id": "end_usr_1234567abcdefg",
  "objectType": "end_user",
  "createdAt": "2024-01-01T12:34:56.789Z",
  "companyName": "Acme Inc.",
  "sourceId": "12345678-abcd-abcd-example-1234567890ab",
  "email": "bob@acme.com",
  "integrationConnections": [
    {
      "id": "int_conn_1234567abcdefg",
      "objectType": "integration_connection",
      "createdAt": "2024-01-01T12:34:56.789Z",
      "lastRequestAt": "2024-01-01T12:34:56.789Z",
      "lastSuccessfulRequestAt": "2024-01-01T12:34:56.789Z"
    }
  ]
}