Finalize WhatsApp Business onboarding (iframe-initiated)

Called from the connect-page iframe with the page token + X-Account-Id. Atomically reserves the token, exchanges the OAuth code for an access token, subscribes the app to the WABA, persists the WABA-side fields, then best-effort registers the phone number if provided. Phone registration is non-fatal: on failure the workspace stays WABA-connected and the response carries phone_status="registration_failed".

Authentication

AuthorizationBearer

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

Path parameters

slugstringRequired

Hex-encoded workspace slug

Request

This endpoint expects any.

Response

WABA connected. phone_status reports whether phone registration succeeded.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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

Hex-encoded workspace slug

Account UUID (baked into the iframe page at GET connect-page time)

This endpoint expects any.

WABA connected. phone_status reports whether phone registration succeeded.

$	curl -X POST https://staging-app.lumenia.net/api/v1/workspace/slug/whatsapp/onboard \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"token": "a1b2c3...",
>	"code": "<facebook oauth code>",
>	"waba_id": "1234567890",
>	"phone_number_id": "0987654321",
>	"business_id": "5544332211"
>	}'

$	curl -X POST https://staging-app.lumenia.net/api/v1/workspace/slug/whatsapp/onboard \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"token": "a1b2c3...",
>	"code": "<facebook oauth code>",
>	"waba_id": "1234567890",
>	"phone_number_id": "0987654321",
>	"business_id": "5544332211"
>	}'

Finalize WhatsApp Business onboarding (iframe-initiated)

Finalize WhatsApp Business onboarding (iframe-initiated)

Authentication

Path parameters

Headers

Request

Response

Errors

Authentication

Path parameters

Headers

Request

Response

Errors

1	{
2	"success": true,
3	"waba_status": "connected",
4	"phone_status": "registered"
5	}