# Brand Registration ## Failed `com.twilio.messaging.compliance.brand-registration.brand-failure` Brand 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). **Examples** ```json { "specversion" : "1.0", "type" : "com.twilio.messaging.compliance.brand-registration.brand-failure", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/A2P.BrandRegistrationFailure/3", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "accountsid" : "AC0000000000000000000000000000001", "brandsid" : "BN0000000000000000000000000000001", "brandstatus" : "registration_failed", "createddate" : 1756043494500, "updateddate" : 1756043494500, "brandregistrationerrors" : [ { "registrationerrorcode" : 21736, "registrationerrordescription" : "The Brand contact email is invalid.", "registrationerrorurl" : "https://www.twilio.com/docs/api/errors/21736", "registrationerrorfields" : [ "brand_contact_email" ] } ] } } ``` **Versions** #### v3 (latest) > \[!NOTE] > > v3 only contains updates to the schema metadata. In other words, there are no new fields between v2 and v3. * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created. * `integer` **updateddate**. The last brand update date. * `object[]` **brandregistrationerrors**. List of errors that occurred during brand registration. * `string` **registrationerrordescription**. Error code. * `integer` **registrationerrorcode**. Error message. * `string[]` **registrationerrorfields**. List of fields that caused the error. * `string` **registrationerrorurl**. URL to the error documentation. The full specification for version 3 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistrationFailure/3). #### v2 * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created. * `integer` **updateddate**. The last brand update date. * `object[]` **brandregistrationerrors**. \[NEW] List of errors that occurred during brand registration. * `string` **registrationerrordescription**. Error code. * `integer` **registrationerrorcode**. Error message. * `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.BrandRegistrationFailure/2). #### v1 * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created. * `integer` **updateddate**. The last brand update date. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistrationFailure/1). ## Registered `com.twilio.messaging.compliance.brand-registration.brand-registered` Brand Registration Registered 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.brand-registration.brand-registered", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/A2P.BrandRegistered/2", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "accountsid" : "AC0000000000000000000000000000001", "brandsid" : "BN0000000000000000000000000000001", "brandstatus" : "registered", "externalbrandid" : "B000001", "createddate" : 1756043494500, "updateddate" : 1756043494500 } } ``` **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` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created. * `integer` **updateddate**. The last brand update date. The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistered/2). #### v1 * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created. * `integer` **updateddate**. The last brand update date. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistered/1). ## Secondary Vetting Failed `com.twilio.messaging.compliance.brand-registration.brand-secondary-vetting-failure` Brand Registration Secondary Vetting 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). **Examples** ```json { "specversion" : "1.0", "type" : "com.twilio.messaging.compliance.brand-registration.brand-secondary-vetting-failure", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/A2P.BrandRegistrationSecondaryVettingFailure/2", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "accountsid" : "AC0000000000000000000000000000001", "brandsid" : "BN0000000000000000000000000000001", "brandstatus" : "registered", "externalbrandid" : "B000001", "brandscore" : 16, "vettingscore" : 16, "identitystatus" : "verified", "brandfeedback" : "GOVERNMENT_ENTITY", "brandvettingoutcome" : "failed", "createddate" : 1756043494500, "updateddate" : 1756043494500, "brandregistrationerrors" : [ { "registrationerrordescription" : "Brand Registration Feedback: The company’s submission as a Government Entity type could not be confirmed from independent sources", "registrationerrorcode" : 30797, "registrationerrorfields" : [ "entity_type" ], "registrationerrorurl" : "https://www.twilio.com/docs/api/errors/30797" } ] } } ``` **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` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created in epoch millis. * `integer` **updateddate**. The last brand update date in epoch millis. * `object[]` **brandregistrationerrors**. List of errors that occurred during brand registration. * `string` **registrationerrordescription**. Error code. * `integer` **registrationerrorcode**. Error message. * `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.BrandRegistrationSecondaryVettingFailure/2). #### v1 * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created in epoch ms. * `integer` **updateddate**. The last brand update date in epoch ms. * `object[]` **brandregistrationerrors**. List of errors that occurred during brand registration. * `string` **registrationerrordescription**. Error code. * `integer` **registrationerrorcode**. Error message. * `string[]` **registrationerrorfields**. List of fields that caused the error. * `string` **registrationerrorurl**. URL to the error documentation. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistrationSecondaryVettingFailure/1). ## Unverified `com.twilio.messaging.compliance.brand-registration.brand-unverified` Brand Registration Unverified 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.brand-registration.brand-unverified", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/A2P.BrandRegisteredUnverified/3", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "accountsid" : "AC0000000000000000000000000000001", "brandsid" : "BN0000000000000000000000000000001", "brandstatus" : "registered", "externalbrandid" : "B000001", "identitystatus" : "unverified", "brandfeedback" : "STOCK_SYMBOL,TAX_ID", "createddate" : 1756043494500, "updateddate" : 1756043494500, "brandregistrationerrors" : [ { "registrationerrordescription" : "Brand Registration Feedback: The submitted stock symbol and stock exchange could not be verified for the submitted legal company name.", "registrationerrorcode" : 30796, "registrationerrorfields" : [ "stock_ticker", "stock_exchange", "business_name" ], "registrationerrorurl" : "https://www.twilio.com/docs/api/errors/30796" } ] } } ``` **Versions** #### v3 (latest) > \[!NOTE] > > v3 only contains updates to the schema metadata. In other words, there are no new fields between v2 and v3. * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created in epoch ms. * `integer` **updateddate**. The last brand update date in epoch ms. * `object[]` **brandregistrationerrors**. List of errors that occurred during brand registration. * `string` **registrationerrordescription**. Error code. * `integer` **registrationerrorcode**. Error message. * `string[]` **registrationerrorfields**. List of fields that caused the error. * `string` **registrationerrorurl**. URL to the error documentation. The full specification for version 3 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegisteredUnverified/3). #### v2 * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created in epoch ms. * `integer` **updateddate**. The last brand update date in epoch ms. * `object[]` **brandregistrationerrors**. \[NEW] List of errors that occurred during brand registration. * `string` **registrationerrordescription**. Error code. * `integer` **registrationerrorcode**. Error message. * `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.BrandRegisteredUnverified/2). #### v1 * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created. * `integer` **updateddate**. The last brand update date. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegisteredUnverified/1). ## Verified `com.twilio.messaging.compliance.brand-registration.brand-verified` Brand Registration Verified 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.brand-registration.brand-verified", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/A2P.BrandRegistrationVerified/2", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "accountsid" : "AC0000000000000000000000000000001", "brandsid" : "BN0000000000000000000000000000001", "brandstatus" : "registered", "externalbrandid" : "B000001", "identitystatus" : "verified", "brandfeedback" : "", "createddate" : 1756043494500, "updateddate" : 1756043494500 } } ``` **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` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created in epoch millis. * `integer` **updateddate**. The last brand update date in epoch millis. The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistrationVerified/2). #### v1 * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created in epoch ms. * `integer` **updateddate**. The last brand update date in epoch ms. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistrationVerified/1). ## Vetting Verified `com.twilio.messaging.compliance.brand-registration.brand-vetted-verified` Brand Registration Vetting Verified 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.brand-registration.brand-vetted-verified", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/A2P.BrandRegistrationVettedVerified/2", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "accountsid" : "AC0000000000000000000000000000001", "brandsid" : "BN0000000000000000000000000000001", "brandstatus" : "registered", "externalbrandid" : "B000001", "brandscore" : 80, "vettingscore" : 80, "identitystatus" : "vetted_verified", "brandfeedback" : "", "brandvettingoutcome" : "success", "createddate" : 1756043494500, "updateddate" : 1756043494500 } } ``` **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` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created in epoch millis. * `integer` **updateddate**. The last brand update date in epoch millis. The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistrationVettedVerified/2). #### v1 * `string` **accountsid**. Id of the Twilio account of the pending-review toll free request. * `string` **brandsid**. Unique ID for brand. * `string` **brandstatus**. Brand status. * `string` **externalbrandid**. Unique ID of the matching brand in the registrar. * `integer` **brandscore**. Brand registration score according to the external registration provider. * `integer` **vettingscore**. Vetting score retrieved from the external vetting provider. * `string` **identitystatus**. Identity of the brand based on the supplied information. * `string` **brandfeedback**. Brand feedback IDs. * `string` **brandvettingoutcome**. Field which documents the state of the vetting for a brand. * `integer` **createddate**. Date when brand was created in epoch ms. * `integer` **updateddate**. The last brand update date in epoch ms. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/A2P.BrandRegistrationVettedVerified/1).