Skip to main content
POST
Create a button and its ordered apps from a system template

Authorizations

Authorization
string
header
required

A Contact Button scoped bearer key. Send Authorization: Bearer <token>. Token abilities are enforced independently of workspace membership; both checks must pass. OAuth 2.0 authorization-code flows are not currently available.

Headers

Idempotency-Key
string

Stable 8–120 character key for safe mutation retries.

Required string length: 8 - 120

Path Parameters

workspace
string<uuid>
required
template
enum<string>
required
Available options:
ecommerce,
local-business,
restaurant,
omnichannel,
social-links,
click-to-call,
contact-form,
whatsapp-chat

Body

application/json
title
string
required

Internal button name.

Maximum string length: 255
submission_id
string<uuid>
required

Stable identifier used to make a single template submission idempotent.

button_text
string | null
Maximum string length: 80

Response

201 - application/json

Successful data envelope.

data
any
required
meta
object
required