Create signup
POST/v1/:waba_id/signups
Creates an opt-in signup and returns the id used in the deep link
wa.me/<PHONE_NUMBER>/signup/<SIGNUP_ID>.
On the first creation, include policy with tos.accepted: true. Later calls
don't need it.
Requires the whatsapp_business_management permission.
Request
Responses
- 200
- 401
- 403
- 429
- 502
Meta Cloud API's response, passed through unchanged. The shape depends on the endpoint — see Meta's documentation.
Response Headers
Which rate limit category applied — send, media or default.
Which bucket the other headers describe — key (the API key), session (the dashboard) or account (the account ceiling).
Request ceiling for this category in the current window.
Requests left in the current window.
Missing, malformed, unknown or revoked token (authentication), or a suspended
account (tenant_inactive).
The resource does not belong to your account (forbidden), or the path is on the
mirror's block list (forbidden_endpoint), or your API key is limited to some numbers and
the operation covers the whole account (forbidden).
Rate limit exceeded (rate_limit).
Response Headers
Seconds to wait before retrying.
Which rate limit category applied — send, media or default.
Which bucket the other headers describe — key (the API key), session (the dashboard) or account (the account ceiling).
Request ceiling for this category in the current window.
Requests left in the current window.
Could not reach Meta (upstream_error), Meta answered with a 5xx (meta_error),
or it took longer than 30 seconds.