Submit the A2P registration
curl --request POST \
--url https://api.quo.com/a2p-registration/submit \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'Quo-Api-Version: <quo-api-version>' \
--data '
{
"forbiddenMessageTopicsAcknowledged": true
}
'{
"data": {
"id": "RG123abc",
"draft": true,
"status": "pending",
"statusMessages": [
{
"errorCode": 123,
"errorReason": "<string>",
"fieldName": "<string>",
"fields": [
"<string>"
]
}
],
"type": "standard",
"assignedPnId": "<string>",
"firstSubmittedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"businessInfo": {
"name": "Acme Inc",
"alternateName": "<string>",
"businessType": "Limited Liability Corporation",
"companyType": "Private",
"industry": "<string>",
"employeeCount": 123,
"avgDailyCallVolume": 123,
"regionsOfOperation": [
"Africa"
],
"websiteUrl": "<string>",
"idType": "USA: Employer Identification Number (EIN)",
"idNumber": "<string>",
"ticker": "<string>",
"exchange": "<string>",
"address": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "US"
},
"personOfContact": {
"firstName": "<string>",
"lastName": "<string>",
"jobTitle": "<string>",
"jobPosition": "<string>",
"email": "jsmith@example.com",
"phoneNumber": "<string>"
}
},
"messaging": {
"useCase": "<string>",
"personalUse": true,
"consent": {
"digitalForm": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"mobileApp": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"onSite": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"other": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"physicalForm": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"textMessage": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"verbal": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"websiteForm": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"written": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
}
}
}
}
}{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"trace": "6897907457496870895"
}{
"message": "User is unauthorized to perform this action",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}{
"message": "Payment could not be completed. Check your billing details and any open invoices in the app, then try again.",
"docs": "https://quo.com/docs",
"title": "Payment Failed",
"trace": "6897907457496870895"
}{
"message": "User is forbidden to perform this action",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}{
"message": "The organization has no A2P registration",
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "6897907457496870895"
}{
"message": "Autofill is still running — try again shortly",
"docs": "https://quo.com/docs",
"title": "Conflict",
"trace": "6897907457496870895"
}{
"message": "forbiddenMessageTopicsAcknowledged must be true to submit",
"docs": "https://quo.com/docs",
"title": "Unprocessable Entity",
"trace": "6897907457496870895"
}{
"message": "An unknown error has occurred",
"docs": "https://quo.com/docs",
"title": "Unknown Error",
"trace": "6897907457496870895"
}A2P Registration
Submit the A2P registration
Submit the organization’s A2P (10DLC) draft registration for carrier approval. Validates all fields and preconditions — including subscription status, draft state, and autofill completion — before attempting payment. Returns the updated registration object on success. Any payment outcome other than completed surfaces as a 402 error.
POST
/
a2p-registration
/
submit
Submit the A2P registration
curl --request POST \
--url https://api.quo.com/a2p-registration/submit \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'Quo-Api-Version: <quo-api-version>' \
--data '
{
"forbiddenMessageTopicsAcknowledged": true
}
'{
"data": {
"id": "RG123abc",
"draft": true,
"status": "pending",
"statusMessages": [
{
"errorCode": 123,
"errorReason": "<string>",
"fieldName": "<string>",
"fields": [
"<string>"
]
}
],
"type": "standard",
"assignedPnId": "<string>",
"firstSubmittedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"businessInfo": {
"name": "Acme Inc",
"alternateName": "<string>",
"businessType": "Limited Liability Corporation",
"companyType": "Private",
"industry": "<string>",
"employeeCount": 123,
"avgDailyCallVolume": 123,
"regionsOfOperation": [
"Africa"
],
"websiteUrl": "<string>",
"idType": "USA: Employer Identification Number (EIN)",
"idNumber": "<string>",
"ticker": "<string>",
"exchange": "<string>",
"address": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "US"
},
"personOfContact": {
"firstName": "<string>",
"lastName": "<string>",
"jobTitle": "<string>",
"jobPosition": "<string>",
"email": "jsmith@example.com",
"phoneNumber": "<string>"
}
},
"messaging": {
"useCase": "<string>",
"personalUse": true,
"consent": {
"digitalForm": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"mobileApp": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"onSite": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"other": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"physicalForm": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"textMessage": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"verbal": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"websiteForm": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
},
"written": {
"enabled": true,
"askForConsentExample": "<string>",
"screenshotUrl": "<string>",
"storeUrl": "<string>",
"text": "<string>",
"url": "<string>"
}
}
}
}
}{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"trace": "6897907457496870895"
}{
"message": "User is unauthorized to perform this action",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}{
"message": "Payment could not be completed. Check your billing details and any open invoices in the app, then try again.",
"docs": "https://quo.com/docs",
"title": "Payment Failed",
"trace": "6897907457496870895"
}{
"message": "User is forbidden to perform this action",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}{
"message": "The organization has no A2P registration",
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "6897907457496870895"
}{
"message": "Autofill is still running — try again shortly",
"docs": "https://quo.com/docs",
"title": "Conflict",
"trace": "6897907457496870895"
}{
"message": "forbiddenMessageTopicsAcknowledged must be true to submit",
"docs": "https://quo.com/docs",
"title": "Unprocessable Entity",
"trace": "6897907457496870895"
}{
"message": "An unknown error has occurred",
"docs": "https://quo.com/docs",
"title": "Unknown Error",
"trace": "6897907457496870895"
}Authorizations
Headers
API version header. Supported values: 2026-03-30
Available options:
2026-03-30 Body
application/json
Must be true. The caller acknowledges that they will not use the A2P service to send messages about forbidden topics. The request is rejected with 422 if this field is false. See https://support.quo.com/getting-started/carrier-registration/carrier-registration#registration-process for the registration process.
Response
OK
Show child attributes
Show child attributes
Was this page helpful?