Skip to contentSkip to navigationSkip to topbar
Twilio Docs
Page tools
Useful for sharing or LLM
On this page
Looking for more inspiration?Visit the

A2P 10DLC - Brand 2FA Verification Resource

(warning)

Warning

This API reference supplements the A2P 10DLC brand registration guide. Review that guide before you use this API.

The 2FA Verification resource retriggers a two-factor authentication (2FA) email for Authentication+ association with the BrandRegistration resource.

The 2FA Verification resource is a subresource of the BrandRegistration resource.

Base URL

base-url page anchor

All URLs referenced in the API documentation have the following base:

https://messaging.twilio.com/v1/a2p/BrandRegistrations

Create a 2FA Verification resource

create-a-2fa-verification-resource page anchor

Resource URL: https://messaging.twilio.com/v1/a2p/BrandRegistrations/{BrandSid}/2fa

To initiate a 2FA Verification for the Brand, make a POST request to this resource.

See the following code sample for a complete curl request.

Use your API key SID and API key secret for TWILIO_API_KEY and TWILIO_API_SECRET. To create an API key, see Create and manage API keys in the Console.

1
curl -X POST "https://messaging.twilio.com/v1/a2p/BrandRegistrations/BNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/2fa" \

2
  -u "$TWILIO_API_KEY:$TWILIO_API_SECRET" \

3
  -H "Content-Type: application/json"
(warning)

Warning

Don't create a UsAppToPerson resource until the BrandRegistration resource's vetting_status is FAILED.

You can check the vetting_status through fetching the BrandVetting resource.

Once the BrandVetting status is FAILED and the 2FA Verification is initiated, a new email will be sent and this will incur a new Authentication+ fee.