Skip to main content

List Phone Numbers

List Phone Numbers lists the phone numbers registered on a WhatsApp Business Account. Use it to find a number's Phone Number ID for Send Message, or to check that a WABA ID is right and the connection can reach it.

It calls GET https://graph.facebook.com/v23.0/{wabaId}/phone_numbers.

The activity has four tabs: Configuration, Auth, Input and Output.

Configuration​

FieldRequiredDescription
NameOptionalName of the step, should be unique within this workflow.
DescriptionOptionalDescribe the purpose or function of this step.
WABA IDOptionalWhatsApp Business Account id. Not the app id or phone number id. Sent as the wabaId path parameter; Meta needs it.

Auth​

FieldRequiredDescription
Auth TypeOptionalOAuth 2, the only option. WhatsApp uses the Meta OAuth connection.
WhatsApp ConnectionOptionalThe WhatsApp resource, which needs the whatsapp_business_management scope.

Input​

This activity is built on the REST Client. It sends no request body. You can map pathParams.wabaId from an earlier step here.

FieldRequiredData TypeDescription
TargetRequiredObjectThe HTTP request.

Output​

The activity returns an httpResponse object (status.code, status.message, headers, body). The response body carries:

FieldData TypeDescription
data[].idStringThe Phone Number ID to use in Send Message.
data[].display_phone_numberStringThe phone number as shown to recipients.
data[].verified_nameStringThe business display name.

If the call fails with error 100, subcode 33, the WABA ID is wrong or the connection can't access that account. See Troubleshooting.