Skip to main content
POST
Open a Leap support case

Authorizations

X-API-Key
string
header
required

Your partner API key. Use raas_sandbox_* keys for the sandbox environment and raas_live_* keys for production.

Body

application/json
referenceId
string
required

End user id in the partner system (for Lola, wa:<E.164>). This is the only identity the partner sends. A RaaS userId is not required: the person may not have onboarded yet, so no User row exists. The case is stored on this referenceId. If a User with the same partnerId and referenceId already exists, the inbox item also gets that userId.

Example:

"wa:+5215512345678"

subtype
enum<string>
required
Available options:
general,
cancellation_intent,
operation_issue
summary
string
required

What the user needs, followed by a recent transcript the agent can read before opening the console

Maximum string length: 4000
externalUrl
string
required

HTTPS URL of the partner console. http is accepted only for localhost.

Example:

"https://lola.example.com/support/console"

severity
enum<string>

Inbox priority. When omitted, cancellation_intent is high and every other subtype is medium.

Available options:
low,
medium,
high,
critical
externalRef
string

Partner-side id for this conversation, stored as-is

channel
string

Descriptive channel label. The platform does not branch on it.

Example:

"whatsapp"

operationId
string

Operation this case is about. Must belong to the caller.

Response

200

Case opened or already open