Create the A2P registration
curl --request POST \
--url https://api.quo.com/a2p-registration \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'Quo-Api-Version: <quo-api-version>' \
--data '
{
"name": "Acme Inc",
"businessType": "Limited Liability Corporation",
"companyType": "Private",
"industry": "Technology",
"employeeCount": 25,
"avgDailyCallVolume": 100,
"regionsOfOperation": [
"USA and Canada"
],
"websiteUrl": "https://acme.example",
"idType": "USA: Employer Identification Number (EIN)",
"idNumber": "12-3456789",
"address": {
"line1": "1 Main St",
"city": "San Francisco",
"region": "CA",
"postalCode": "94110",
"country": "US",
"line2": "Suite 200"
},
"personOfContact": {
"firstName": "Ada",
"lastName": "Lovelace",
"jobTitle": "CTO",
"jobPosition": "Director",
"email": "ada@acme.example",
"phoneNumber": "+15551234567"
},
"messageTypes": [
"customer_support",
"transactional_notifications"
],
"alternateName": "Acme",
"ticker": "ACME",
"exchange": "NASDAQ"
}
'{
"data": {
"id": "RG123abc",
"draft": true,
"status": "pending",
"statusMessages": [
{
"errorCode": 123,
"errorReason": "<string>",
"fieldName": "<string>",
"fields": [
"<string>"
]
}
],
"autofillStatus": "completed",
"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": "Unauthorized",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}{
"message": "This subscription is not able to register for A2P",
"docs": "https://quo.com/docs",
"title": "Subscription Expired",
"trace": "6897907457496870895"
}{
"message": "You must be an organization admin or owner to create an A2P registration",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}{
"message": "Not Found",
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "6897907457496870895"
}{
"message": "This organization already has an A2P registration",
"docs": "https://quo.com/docs",
"title": "Conflict",
"trace": "6897907457496870895"
}{
"message": "idNumber must contain exactly nine digits for idType USA: Employer Identification Number (EIN)",
"docs": "https://quo.com/docs",
"title": "Unprocessable Entity",
"trace": "6897907457496870895"
}{
"message": "We have encountered an unknown error",
"docs": "https://quo.com/docs",
"title": "Unexpected",
"trace": "6897907457496870895"
}A2P Registration
Create the A2P registration
Create the organization’s A2P (10DLC) draft registration. Organizations have at most one registration, so this returns 409 if one already exists.
POST
/
a2p-registration
Create the A2P registration
curl --request POST \
--url https://api.quo.com/a2p-registration \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'Quo-Api-Version: <quo-api-version>' \
--data '
{
"name": "Acme Inc",
"businessType": "Limited Liability Corporation",
"companyType": "Private",
"industry": "Technology",
"employeeCount": 25,
"avgDailyCallVolume": 100,
"regionsOfOperation": [
"USA and Canada"
],
"websiteUrl": "https://acme.example",
"idType": "USA: Employer Identification Number (EIN)",
"idNumber": "12-3456789",
"address": {
"line1": "1 Main St",
"city": "San Francisco",
"region": "CA",
"postalCode": "94110",
"country": "US",
"line2": "Suite 200"
},
"personOfContact": {
"firstName": "Ada",
"lastName": "Lovelace",
"jobTitle": "CTO",
"jobPosition": "Director",
"email": "ada@acme.example",
"phoneNumber": "+15551234567"
},
"messageTypes": [
"customer_support",
"transactional_notifications"
],
"alternateName": "Acme",
"ticker": "ACME",
"exchange": "NASDAQ"
}
'{
"data": {
"id": "RG123abc",
"draft": true,
"status": "pending",
"statusMessages": [
{
"errorCode": 123,
"errorReason": "<string>",
"fieldName": "<string>",
"fields": [
"<string>"
]
}
],
"autofillStatus": "completed",
"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": "Unauthorized",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}{
"message": "This subscription is not able to register for A2P",
"docs": "https://quo.com/docs",
"title": "Subscription Expired",
"trace": "6897907457496870895"
}{
"message": "You must be an organization admin or owner to create an A2P registration",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}{
"message": "Not Found",
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "6897907457496870895"
}{
"message": "This organization already has an A2P registration",
"docs": "https://quo.com/docs",
"title": "Conflict",
"trace": "6897907457496870895"
}{
"message": "idNumber must contain exactly nine digits for idType USA: Employer Identification Number (EIN)",
"docs": "https://quo.com/docs",
"title": "Unprocessable Entity",
"trace": "6897907457496870895"
}{
"message": "We have encountered an unknown error",
"docs": "https://quo.com/docs",
"title": "Unexpected",
"trace": "6897907457496870895"
}Authorizations
Headers
API version header. Supported values: 2026-03-30
Available options:
2026-03-30 Body
application/json
The legal or registered name of the business.
Required string length:
1 - 255Example:
"Acme Inc"
businessType
Option 1 · stringOption 2 · stringOption 3 · stringOption 4 · stringOption 5 · stringOption 6 · string
required
The legal structure of the business: one of Sole Proprietorship, Partnership, Corporation, Co-operative, Limited Liability Corporation, Non-profit Corporation.
Allowed value:
"Sole Proprietorship"Example:
"Limited Liability Corporation"
The type of company. ticker and exchange are required when this is Public.
Allowed value:
"Private"Example:
"Private"
industry
Option 1 · stringOption 2 · stringOption 3 · stringOption 4 · stringOption 5 · stringOption 6 · stringOption 7 · stringOption 8 · stringOption 9 · stringOption 10 · stringOption 11 · stringOption 12 · stringOption 13 · stringOption 14 · stringOption 15 · stringOption 16 · stringOption 17 · stringOption 18 · stringOption 19 · stringOption 20 · stringOption 21 · stringOption 22 · stringOption 23 · stringOption 24 · stringOption 25 · stringOption 26 · stringOption 27 · stringOption 28 · stringOption 29 · stringOption 30 · stringOption 31 · string
required
The industry the business operates in: one of Agriculture, Automotive, Banking, Consumer, Education, Electronics, Energy, Engineering, Fast moving consumer goods, Financial, Fintech, Food and beverage, Government, Healthcare, Hospitality, Insurance, Jewelry, Legal, Manufacturing, Media, Not for profit, Oil and gas, Online, Raw materials, Real estate, Religion, Retail, Technology, Telecommunications, Transportation, Travel.
Allowed value:
"Agriculture"Example:
"Technology"
The number of employees at the business.
Required range:
x >= 1Example:
25
The business's average daily call volume.
Required range:
x >= 1Example:
100
The regions the business operates in. Each entry is one of Africa, Asia, Europe, Latin America, USA and Canada.
Required array length:
1 - 5 elementsAllowed value:
"Africa"Example:
["USA and Canada"]
The business's website URL.
Required string length:
1 - 255Example:
"https://acme.example"
idType
Option 1 · stringOption 2 · stringOption 3 · stringOption 4 · stringOption 5 · stringOption 6 · stringOption 7 · stringOption 8 · stringOption 9 · string
required
The type of the business's government-issued tax ID: one of USA: Employer Identification Number (EIN), Canada: Canadian Business Number (BN-9), Great Britain: Company Number, Australia: Company Number from ASIC (ACN), India: Corporate Identity Number, Estonia: VAT Number, Romania: VAT Registration Number, Israel: Registration Number, Other.
Allowed value:
"USA: Employer Identification Number (EIN)"Example:
"USA: Employer Identification Number (EIN)"
The business's government-issued tax ID number. An EIN must carry exactly nine digits, and separators such as the dash in 12-3456789 are ignored. A Canadian BN-9 must be exactly nine digits with no separators.
Required string length:
1 - 255Example:
"12-3456789"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The message-use types that autofill uses for this request. The registration does not store this value: send it again on any later request that starts autofill.
Minimum array length:
1Allowed value:
"appointments_scheduling"Example:
[
"customer_support",
"transactional_notifications"
]
An alternate or doing-business-as name for the business.
Required string length:
1 - 255Example:
"Acme"
The business's stock ticker symbol. Required when companyType is Public.
Required string length:
1 - 255Example:
"ACME"
exchange
Option 1 · stringOption 2 · stringOption 3 · stringOption 4 · stringOption 5 · stringOption 6 · stringOption 7 · stringOption 8 · stringOption 9 · stringOption 10 · stringOption 11 · stringOption 12 · stringOption 13 · stringOption 14 · stringOption 15 · stringOption 16 · stringOption 17 · stringOption 18 · stringOption 19 · stringOption 20 · stringOption 21 · stringOption 22 · stringOption 23 · stringOption 24 · stringOption 25 · stringOption 26 · string
The stock exchange the business's ticker is listed on. Required when companyType is Public. One of NASDAQ, NYSE, AMEX, AMX, ASX, B3, BME, BSE, FRA, ICEX, JPX, JSE, KRX, LON, NSE, OMX, SEHK, SGX, SSE, STO, SWX, SZSE, TSX, TWSE, VSE, Other.
Allowed value:
"NASDAQ"Example:
"NASDAQ"
Response
Created
Show child attributes
Show child attributes
Was this page helpful?