Sign in
latestOpenAPI 3.0.2MIT2026-08-1745267541.8 KB

bdb3e0c48bf7

App

Create an app

You can create a new Conversation API app using the API. You can create an app for one or more channels at once. The ID of the app is generated at creation and will be returned in the response.

post/v1/projects/{project_id}/apps

Request body

conversation_metadata_report_view'NONE' | 'FULL'

NONE - Omit metadata. FULL - Include all metadata assigned to the conversation.

display_namestring required

The display name for the app.

processing_mode'CONVERSATION' | 'DISPATCH'

Whether or not Conversation API should store contacts and conversations for the app. For more information, see Processing Modes.

Example request

{
  "channel_credentials": [
    {
      "channel": "WHATSAPP"
    }
  ],
  "display_name": "Sinch Conversation API Demo App 001"
}

Response

A successful response.

conversation_metadata_report_view'NONE' | 'FULL'

NONE - Omit metadata. FULL - Include all metadata assigned to the conversation.

display_namestring

The display name for the app.

idstring

The ID of the app. You can find this on the Sinch Dashboard.

processing_mode'CONVERSATION' | 'DISPATCH'

Whether or not Conversation API should store contacts and conversations for the app. For more information, see Processing Modes.

Example response

{
  "channel_credentials": [
    {
      "channel": "WHATSAPP"
    }
  ],
  "display_name": "Sinch Conversation API Demo App 001",
  "id": "{APP_ID}"
}