WhatsAble

Create a link that connects a WhatsApp number with no login

posthttps://api.whatsable.app/v1/number-connect-links
Build a request to copy

This page never sends a request. Fill in the fields, then copy the request and run it from your server.

Request
curl -X POST 'https://api.whatsable.app/v1/number-connect-links' \
  -H 'Content-Type: application/json' \
  -d '{}'

Creates a page that connects a WhatsApp Business number to this organization through Meta's signup, with no WhatsAble login. Give it to the person who will connect the number, or send email to email it to them, with the person this key acts for in CC.

Only a key with Full access. The link lets its holder add a number to the organization, so a key with a list of scopes answers 403 insufficient_scope.

The link is valid for 24 hours. Opening the page does not use it up: it is used up when a number connects through it. A used or expired link shows a page that says so; create a new one.

Authorization

bearerAuth
headerAuthorizationBearer <nfy_live_<32 characters>>

An API key from Settings > API keys, sent as Authorization: Bearer <key>.

Header Parameters

Idempotency-Key?string

Any string up to 255 characters. A repeat with the same key and body answers the stored response; with another body, 409 idempotency_key_reused.

Lengthlength <= 255

Request Body

application/json
  1. body

Who receives the link. An empty body only creates it.

email?string

Email the link to this address, with the person the credential acts for in CC. Absent: only return the link.

Lengthlength <= 320
name?string

The recipient's name, for the greeting of the email. Read only with email.

Length1 <= length <= 100

Response Body

The link, and where it was sent.

application/json
  1. response

A link that connects a WhatsApp number to this organization, with no login.

object*string
url*string

The page that connects a WhatsApp number. It needs no login, so share it only with the person who connects the number.

expires_at*string

24 hours after creation. Opening the page does not use the link up; a connected number does.

Formatdate-time
sent_to*|

The address the link was emailed to, or null when it was only created.

Example Request
curl -X POST 'https://api.whatsable.app/v1/number-connect-links' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "object": "number_connect_link",  "url": "https://app.whatsable.app/connect-number/cm2v8l1a00001qz8h2b3c4d5e.Hk3x9Qe2v7LwYb1pZ0aTfN5sR8uC4mJ6dG2iK0oE1yV",  "expires_at": "2026-11-13T12:00:00Z",  "sent_to": "ana@example.com"}