Skip to main content
POST
/
v1
/
numbers
/
meta
Create Meta number (Cloud API)
curl --request POST \
  --url https://pilotstatus.com.br/v1/numbers/meta \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Atendimento",
  "number": "5511999999999",
  "metaPhoneId": "123456789012345",
  "metaWabaId": "987654321098765",
  "metaAccessToken": "EAAG...",
  "metaAppSecret": "a1b2c3...",
  "metaAppId": "100200300400500"
}
'
{
  "number": {
    "id": "num_01HZX...",
    "number": "5511999999999",
    "name": "Atendimento",
    "provider": "META",
    "metaPhoneId": "123456789012345",
    "metaWabaId": "987654321098765",
    "isFullyConnected": true,
    "createdAt": "2026-06-20T10:00:00.000Z"
  },
  "webhook": {
    "url": "https://webhook.pilotstatus.com.br/meta",
    "verifyToken": "ps_meta_verify_..."
  },
  "linkedApiKeyId": "key_01HZX..."
}

Authorizations

​
x-api-key
string
header
required

Your ps_ API key

Body

application/json
​
name
string
required

Display name for the number.

Example:

"Atendimento"

​
number
string
required

Phone number (min 8 digits, optional +).

Example:

"5511999999999"

​
metaPhoneId
string
required

Meta Cloud API Phone Number ID.

Example:

"123456789012345"

​
metaWabaId
string
required

WhatsApp Business Account (WABA) ID.

Example:

"987654321098765"

​
metaAccessToken
string
required

System-user access token.

Example:

"EAAG..."

​
metaAppSecret
string
required

Meta app App Secret.

Example:

"a1b2c3..."

​
metaAppId
string
required

Meta app App ID.

Example:

"100200300400500"

​
linkToApiKey
boolean

Link the number to the calling API key (default true).

Example:

"true"

Response

Create Meta number