Skip to main content
POST
/
v2.0
/
projects
/
{projectId}
/
setupinbox
Set Up a Live Agent Inbox
curl --request POST \
  --url https://api-trial.cognigy.ai/new/v2.0/projects/{projectId}/setupinbox \
  --header 'X-API-Key: <api-key>'
{
  "type": "Bad Request",
  "title": "Bad Request Error",
  "status": 400,
  "detail": "Validation failed. Missing payload.",
  "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432",
  "code": 1000,
  "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f",
  "details": {}
}

Authorizations

​
X-API-Key
string
header
required

Supply the API Key in the HTTP-Header

Headers

​
Accept
enum<string>

The Accept header specifies the media type that the client expects in the response. Available options: application/json, application/hal+json, application/xml, text/xml, text/csv. The default value is application/json.

Available options:
application/json,
application/hal+json,
application/xml,
text/xml,
text/csv

Path Parameters

​
projectId
string
required
Required string length: 24
Pattern: ^[a-z0-9]{24}$

Response

Cognigy Live agent Inbox was successfully setup for the project and returns the inbox id or an error message.

Last modified on June 12, 2026