Create client

POST /clients
O auth2
application/json

Body Required

  • customId string

    A custom identifier for internal reference by your system (not used by missionX).

  • title string Required

    The name of the client.

  • emailDomains array[string]

    The last part (after the @) of any client emails you might want to give access to projects. E.g. missionx.ai

  • departments array[string]

    One or more department IDs associated with this client, i.e. org.departments[]._id

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • _id string(ObjectId)

      The unique document ID.

    • createdBy string(ObjectId)

      The creator's unique document ID.

    • createdAt string(date-time)

      The date the document was created in ISOString format. See .toISOString().

    • updatedAt string(date-time)

      The date the document was last updated in ISOString format. See .toISOString().

    • customId string

      A custom identifier for internal reference by your system (not used by missionX).

    • title string

      The name of the client.

    • emailDomains array[string]

      The last part (after the @) of any client emails you might want to give access to projects. E.g. missionx.ai

    • departments array[string]

      One or more department IDs associated with this client, i.e. org.departments[]._id
  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • message string

      An error message.

    • code string

      An error code to handle specific error responses.

    • data object

      Optionally, additional data to help handle the error.

      Additional properties are allowed.
  • 500 application/json

    Internal Server Error

    Hide response attributes Show response attributes object
    • message string

      An error message.

    • code string

      An error code to handle specific error responses.

    • data object

      Optionally, additional data to help handle the error.

      Additional properties are allowed.
POST /clients 
curl \
 --request POST 'https://open.api.missionx.ai/v2/clients' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"customId":"string","title":"string","emailDomains":["string"],"departments":["string"]}'
Request examples 
{
  "customId": "string",
  "title": "string",
  "emailDomains": [
    "string"
  ],
  "departments": [
    "string"
  ]
}
Response examples (200) 
{
  "_id": "string",
  "createdBy": "string",
  "createdAt": "2025-05-04T09:42:00Z",
  "updatedAt": "2025-05-04T09:42:00Z",
  "customId": "string",
  "title": "string",
  "emailDomains": [
    "string"
  ],
  "departments": [
    "string"
  ]
}
Response examples (400) 
{
  "message": "string",
  "code": "string",
  "data": {}
}
Response examples (500) 
{
  "message": "string",
  "code": "string",
  "data": {}
}