# Campaign Registration

## Approved

`com.twilio.messaging.compliance.campaign-registration.campaign-approved`

Campaign Registration Approved events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/messaging/compliance/a2p-10dlc/event-streams-setup).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.campaign-registration.campaign-approved",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/A2P.CampaignRegistrationApproved/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "brandsid" : "BN0000000000000000000000000000001",
    "campaignsid" : "CM0000000000000000000000000000001",
    "messagingservicesid" : "MG0000000000000000000000000000001",
    "externalcampaignid" : "C000001",
    "a2pusecase" : "LOW_VOLUME",
    "createddate" : 1756043494500,
    "updateddate" : 1756043494500,
    "campaignregistrationstatus" : "approved",
    "timestamp" : 1756043494500,
    "errorcode" : 30991
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **accountsid**. Id of the Twilio account of the pending-review toll free request.
* `string` **brandsid**. Unique ID for brand.
* `string` **campaignsid**. Unique ID for campaign.
* `string` **messagingservicesid**. Unique ID for messaging service.
* `string` **externalcampaignid**. Unique ID of the matching campaign in the registrar.
* `string` **a2pusecase**. Use case for campaign registration.
* `integer` **createddate**. Date when campaign was created in epoch millis.
* `integer` **updateddate**. The last campaign update date.
* `string` **campaignregistrationstatus**. The campaign registration status.
* `integer` **timestamp**. Campaign registration event timestamp.
* `integer` **errorcode**. The twilio error code associated with campaign registration event.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.CampaignRegistrationApproved/2).

#### v1

* `string` **accountsid**. Id of the Twilio account of the pending-review toll free request.
* `string` **brandsid**. Unique ID for brand.
* `string` **campaignsid**. Unique ID for campaign.
* `string` **messagingservicesid**. Unique ID for messaging service.
* `string` **externalcampaignid**. Unique ID of the matching campaign in the registrar.
* `string` **a2pusecase**. Use case for campaign registration.
* `integer` **createddate**. Date when campaign was created.
* `integer` **updateddate**. The last campaign update date.
* `string` **campaignregistrationstatus**. The campaign registration status.
* `integer` **timestamp**. Campaign registration event timestamp.
* `integer` **errorcode**. The twilio error code associated with campaign registration event.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.CampaignRegistrationApproved/1).

## Deleted

`com.twilio.messaging.compliance.campaign-registration.campaign-deleted`

Campaign Registration Deleted events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/messaging/compliance/a2p-10dlc/event-streams-setup).

**Versions**

#### v1 (latest)

* `string` **accountsid**. Unique ID for Twilio account.
* `string` **brandsid**. Unique ID for brand.
* `string` **campaignsid**. Unique ID for campaign.
* `string` **messagingservicesid**. Unique ID for messaging service.
* `string` **externalcampaignid**. Unique ID for matching campaign in the registrar.
* `string` **a2pusecase**. Use case for campaign registration.
* `integer` **createddate**. Date when campaign was created in epoch millis.
* `integer` **updateddate**. Date when campaign was last updated in epoch millis.
* `string` **campaignregistrationstatus**. The campaign registration status.
* `integer` **errorcode**. The Twilio error code associated with the campaign registration event.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.CampaignRegistrationDeleted/1).

## Failed

`com.twilio.messaging.compliance.campaign-registration.campaign-failure`

Campaign Registration Failed events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/messaging/compliance/a2p-10dlc/event-streams-setup).

**Versions**

#### v2 (latest)

* `string` **accountsid**. Id of the Twilio account of the pending-review toll free request.
* `string` **brandsid**. Unique ID for brand.
* `string` **campaignsid**. Unique ID for campaign.
* `string` **messagingservicesid**. Unique ID for messaging service.
* `string` **externalcampaignid**. Unique ID of the matching campaign in the registrar.
* `string` **a2pusecase**. Use case for campaign registration.
* `integer` **createddate**. Date when campaign was created.
* `integer` **updateddate**. The last campaign update date.
* `string` **campaignregistrationstatus**. The campaign registration status.
* `integer` **timestamp**. Campaign registration event timestamp.
* `integer` **errorcode**. The twilio error code associated with campaign registration event.
* `object[]` **campaignregistrationerrors**. \[NEW] List of errors that occurred during campaign registration.
  * `string` **registrationerrordescription**. Error message.
  * `integer` **registrationerrorcode**. Error code.
  * `string[]` **registrationerrorfields**. List of fields that caused the error.
  * `string` **registrationerrorurl**. URL to the error documentation.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.CampaignRegistrationFailure/2).

#### v1

* `string` **accountsid**. Id of the Twilio account of the pending-review toll free request.
* `string` **brandsid**. Unique ID for brand.
* `string` **campaignsid**. Unique ID for campaign.
* `string` **messagingservicesid**. Unique ID for messaging service.
* `string` **externalcampaignid**. Unique ID of the matching campaign in the registrar.
* `string` **a2pusecase**. Use case for campaign registration.
* `integer` **createddate**. Date when campaign was created.
* `integer` **updateddate**. The last campaign update date.
* `string` **campaignregistrationstatus**. The campaign registration status.
* `integer` **timestamp**. Campaign registration event timestamp.
* `integer` **errorcode**. The twilio error code associated with campaign registration event.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.CampaignRegistrationFailure/1).

## Submitted

`com.twilio.messaging.compliance.campaign-registration.campaign-submitted`

Campaign Registration Submitted events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/messaging/compliance/a2p-10dlc/event-streams-setup).

**Versions**

#### v1 (latest)

* `string` **accountsid**. Id of the Twilio account of the pending-review toll free request.
* `string` **brandsid**. Unique ID for brand.
* `string` **campaignsid**. Unique ID for campaign.
* `string` **messagingservicesid**. Unique ID for messaging service.
* `string` **externalcampaignid**. Unique ID of the matching campaign in the registrar.
* `string` **a2pusecase**. Use case for campaign registration.
* `integer` **createddate**. Date when campaign was created.
* `integer` **updateddate**. The last campaign update date.
* `string` **campaignregistrationstatus**. The campaign registration status.
* `integer` **timestamp**. Campaign registration event timestamp.
* `integer` **errorcode**. The twilio error code associated with campaign registration event.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.CampaignRegistrationSubmitted/1).