For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact us
DocumentationAPI Reference
DocumentationAPI Reference
  • Authentication
    • GETVerify API key
  • Documents
    • POSTUpload document
    • POSTUpload document into folder
    • GETList documents
    • GETList documents in folder
    • GETGet document
    • POSTCreate folder
    • DELDelete folder
    • POSTMove documents between folders
    • DELDelete documents
  • Workspaces
    • GETGet workspace
    • DELDelete workspace
    • POSTUpdate workspace
    • POSTAdd or remove workspace embeddings
    • GETList workspace tools
    • POSTAttach tool to workspace
    • DELDetach tool from workspace
  • Number Requests
    • GETList number requests
    • POSTRequest a phone number
    • GETGet number request
  • Numbers
    • GETList phone numbers
    • GETList phone numbers in organization
  • Organizations
    • GETList organizations
    • POSTCreate organization
    • GETGet organization
    • DELDelete organization
    • POSTUpdate organization
    • GETList workspaces in organization
    • POSTCreate workspace
    • GETList organization tools
    • POSTCreate organization tool
    • DELDelete organization tool
    • PATCHUpdate organization tool
  • Accounts
    • GETList accounts
    • POSTCreate account
  • Voice Integration
    • GETGet voice assistant config
    • PATCHUpdate voice assistant config
    • GETGet voice integration catalog
    • POSTProvision voice integration
    • GETList voice call logs
    • GETList workspace voice call logs
  • Whats App Integration
    • POSTMint a WhatsApp Business connect page token
    • GETRender WhatsApp Business connect iframe page
    • POSTFinalize WhatsApp Business onboarding (iframe-initiated)
    • DELDisconnect WhatsApp Business integration
Contact us
LogoLogo
Whats App Integration

Mint a WhatsApp Business connect page token

POST
https://staging-app.lumenia.net/api/v1/workspace/:slug/whatsapp/connect-token
POST
/api/v1/workspace/:slug/whatsapp/connect-token
$curl -X POST https://staging-app.lumenia.net/api/v1/workspace/slug/whatsapp/connect-token \
>     -H "X-Account-Id: X-Account-Id" \
>     -H "Authorization: Bearer <token>"
1{
2  "success": true,
3  "token": "a1b2c3...",
4  "expires_at": "2026-05-25T12:34:56.000Z",
5  "connect_url": "https://api.lumenia.io/api/v1/workspace/61636d65/whatsapp/connect-page?token=a1b2c3..."
6}

Mints a short-TTL single-use page token bound to one workspace and one account. The returned connect_url renders an iframe-embeddable signup page; once the end user completes Meta Embedded Signup the iframe finalizes the integration via the onboard endpoint using this token. The partner API key never reaches the end-user browser.

Was this page helpful?
Previous

Render WhatsApp Business connect iframe page

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

slugstringRequired

Hex-encoded workspace slug

Headers

X-Account-IdstringRequired
Account UUID under the API key partner

Response

Token minted

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error