MEmeta
WhatsApp Business Account Activities

Get WhatsApp Business Account Activities

Retrieve activity logs and audit trails for a WhatsApp Business Account. This endpoint returns a chronological list of activities performed on the account, including administrative actions, configuration changes, and operational events.

Use Cases:

  • Monitor account configuration changes and administrative actions
  • Generate compliance and audit reports for regulatory requirements
  • Track user activities and permission modifications
  • Investigate security incidents and unauthorized access attempts
  • Monitor API usage patterns and operational events

Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

Caching: Activity data can be cached for short periods, but recent activities may change frequently. Implement appropriate cache invalidation strategies.

get/{Version}/{WABA-ID}/activities

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{WABA-ID}/activities
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

WABA-IDstring required

Your WhatsApp Business Account ID. This ID can be found in your WhatsApp Manager or through the business account management APIs.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, activity_type, timestamp, actor_type). Available fields: id, activity_type, timestamp, actor_type, actor_id, actor_name, description, details, ip_address, user_agent

limitinteger

Maximum number of activity records to return per page. Default is 25, maximum is 100.

afterstring

Cursor for pagination. Use this to get the next page of results.

beforestring

Cursor for pagination. Use this to get the previous page of results.

sincestring

Unix timestamp or ISO 8601 date string. Only return activities that occurred after this time.

untilstring

Unix timestamp or ISO 8601 date string. Only return activities that occurred before this time.

activity_typestring

Filter activities by type. Can be a single type or comma-separated list of types.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Response

Successfully retrieved WhatsApp Business Account activities

Example response

{
  "data": [
    {
      "id": "1234567890123456",
      "activity_type": "PHONE_NUMBER_VERIFIED",
      "timestamp": "2023-10-15T14:30:00Z",
      "actor_type": "USER",
      "actor_id": "9876543210987654",
      "actor_name": "John Smith",
      "description": "Phone number configuration updated",
      "details": {
        "phone_number": "+1234567890",
        "previous_status": "UNVERIFIED",
        "new_status": "VERIFIED"
      },
      "ip_address": "192.168.1.100",
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
    }
  ],
  "paging": {
    "cursors": {
      "after": "eyJvZAmZAzZAXQiOjAsInZAlcnNpb25JZACI6IjE3Mzc2Nzk2ODgzODM1ODQifQZDZD",
      "before": "eyJvZAmZAzZAXQiOjAsInZAlcnNpb25JZACI6IjE3Mzc2Nzk2ODgzODM1ODQifQZDZD"
    }
  }
}

Changes

No recorded changes to this operation across all 5 revisions of this API.