Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

WhatsApp Registration API

Register and deregister phone numbers

WhatsApp Registration API is one of 17 APIs that WhatsApp publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Registration. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an AsyncAPI specification, an API reference, a getting-started guide, and 2 JSON Schemas.

This API exposes 4 operations across 4 paths, and defines 1 schema. It is described by OpenAPI 3.1.0, at version 21.0.

Requests are made against a single base URL, https://graph.facebook.com/v21.0.

4 operations 4 paths 1 schemas 4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
21.0
Base URL
https://graph.facebook.com/v21.0
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

WhatsApp Registration API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — System User Token with whatsappbusinessmanagement permission

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 POST. Each is listed below with its method, path, parameters, and response codes.

Registration 4

Register and deregister phone numbers

POST
/{phone-number-id}/request_code
WhatsApp Request Verification Code
requestVerificationCode 1 param body → 200
POST
/{phone-number-id}/verify_code
WhatsApp Verify Phone Number
verifyCode 1 param body → 200
POST
/{phone-number-id}/register
WhatsApp Register Phone Number
registerPhoneNumber 1 param body → 200
POST
/{phone-number-id}/deregister
WhatsApp Deregister Phone Number
deregisterPhoneNumber 1 param body → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is SuccessResponse (1 property). Each schema is shown below with its type and property counts.

SuccessResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

whatsapp-registration-api-openapi.yml Raw ↑

Other APIs WhatsApp publishes across the network.

WhatsApp Flows API
WhatsApp On-Premises API
WhatsApp Analytics API
WhatsApp Assets API
WhatsApp Assigned Users API
WhatsApp Business Accounts API
WhatsApp Business Profile API
WhatsApp Lifecycle API
WhatsApp Media API
WhatsApp Message Templates API
WhatsApp Messages API
WhatsApp Phone Numbers API