Graph API Version

Whats App Business Account Subscribed Apps

Reading

Get a list of apps subscribed to webhooks for the WABA.

Example

GET /v21.0/{whats-app-business-account-id}/subscribed_apps HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{whats-app-business-account-id}/subscribed_apps',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{whats-app-business-account-id}/subscribed_apps",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{whats-app-business-account-id}/subscribed_apps",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{whats-app-business-account-id}/subscribed_apps"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

Reading from this edge will return a JSON formatted result:

{
    "data": [],
    "paging": {}
}

`data`

A list of WhatsAppApplication nodes.

`paging`

For more details about pagination, see the Graph API guide.

Error Codes

Error	Description
100	Invalid parameter
200	Permissions error

Creating

You can make a POST request to subscribed_apps edge from the following paths:

/{whats_app_business_account_id}/subscribed_apps

When posting to this edge, a WhatsAppApplication will be created.

Parameters

Parameter Description

Parameter	Description
`override_callback_uri` URI	Required if overriding the callback URL. New callback URL. See Overriding the Callback URL.
`verify_token` string	Required if overriding the callback URL. Callback verification token. See Overriding the Callback URL.

override_callback_uri

URI

Required if overriding the callback URL.

New callback URL. See Overriding the Callback URL.

verify_token

string

Required if overriding the callback URL.

Callback verification token. See Overriding the Callback URL.

Return Type

This endpoint supports read-after-write and will read the node to which you POSTed.

Struct {

success: bool,

}

Error Codes

Error	Description
100	Invalid parameter
200	Permissions error
2200	subscription validation failed
2201	received an invalid hub.challenge while validating endpoint

Updating

You can't perform this operation on this endpoint.

Deleting

You can dissociate a WhatsAppApplication from a WhatsAppBusinessAccount by making a DELETE request to /{whats_app_business_account_id}/subscribed_apps.

Parameters

This endpoint doesn't have any parameters.

Return Type

Struct {

success: bool,

}

Error Codes

Error	Description
100	Invalid parameter
200	Permissions error