Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Brand Your Calls Using CNAM (Public Beta)



Overview

overview page anchor

CNAM stands for Caller ID Name. CNAM is a feature in the United States public telephone network that identifies an incoming caller by a personal or business name associated with the originating phone number. CNAM is registered by the EndUser assigned the phone number through their Telephony Service Provider (Twilio).

(information)

Info

CNAM lookups are fully supported for Twilio phone numbers registered in the United States. Additionally, your profile must be associated with a registration authority, specifically an EIN (Employer Identification Number) or a DUNS (Data Universal Numbering System) number. CNAM lookups are not available for phone numbers from other countries, including Canada.


There are two different options for enabling CNAM on your phone number(s):

  1. Using the Twilio Console
  2. Twilio's Trust Hub REST API.

Please note CNAM:

  • Can be a maximum of 15 characters.
  • Must be a unique name or value, cannot be a generic value such as a City/State.
  • Should begin with a letter and can only contain letters, numbers, periods, commas and spaces
  • If no Caller Name (CNAM) is set for the number, the City and State of the number is the default display along with phone number.

Note: At this time, you are unable to update Toll-Free numbers CNAM via the Twilio Console or API. To update the CNAM on a Toll-Free number, please contact support(link takes you to an external page).


CNAM Onboarding in the Twilio Console

cnam-onboarding-in-the-twilio-console page anchor
  1. Create a Business Profile in the Console's Trust Hub(link takes you to an external page) and submit for vetting.

    • If you are an ISV, then you would need to create a Secondary Business Profile for your customer(s).
  2. Assign phone numbers in your account to the Business Profile.

    • This associates a single identity with the phone numbers.
  3. Create a CNAM Trust Product instance(link takes you to an external page) that is associated with your in the Trust Hub and submit for vetting.
  4. Select phone numbers for CNAM Registration.

    • Only those phone numbers already assigned to your Business Profile are eligible.
  5. Click Save

    • When the CNAM Trust Product reaches Twilio-Approved status, Twilio will register CNAM display name for your numbers with the CNAM authoritative databases in the United States.

NOTE: You can remove CNAM by unassigning Phone Number from CNAM Trust Product or by deleting the CNAM Trust Product.

That's it. No coding required.


CNAM Onboarding with the Trust Hub REST API

cnam-onboarding-with-the-trust-hub-rest-api page anchor

Please refer to Trust Hub Rest API Docs for more details.

  1. Create a Business Profile in the Console's Trust Hub and submit for vetting.
  1. Assign phone numbers in your account to the Business Profile. This associates a single identity with the phone numbers.
  • You'll need your Phone Number SID(s)

    • To find your Phone Number SIDs in the Console, go to your Dashboard . In the Project Info section, click on See all phone numbers , then click on a phone number to find the SID.
    • To find your Phone Number SIDs via API, see the Additional API Calls section below.
    • Phone Number SIDs begin with " PN ".
    • In the API Call below, don't change the ChannelEndpointType . It needs to be phone-number to add a phone number to your Business Profile.

Assign Phone Numbers to Your Business Profile

assign-phone-numbers-to-your-business-profile page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_17
// Download the helper library from https://www.twilio.com/docs/node/install
_17
import twilio from "twilio";
_17
_17
// Find your Account SID and Auth Token at twilio.com/console
_17
// and set the environment variables. See http://twil.io/secure
_17
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_17
const authToken = process.env.TWILIO_AUTH_TOKEN;
_17
const client = twilio(accountSid, authToken);
_17
_17
const customerProfilesChannelEndpointAssignment = await client.trusthub.v1
_17
.customerProfiles("YOUR_BUSINESS_PROFILE_SID")
_17
.customerProfilesChannelEndpointAssignment.create({
_17
channelEndpointSid: "YOUR_PHONE_NUMBER_SID",
_17
channelEndpointType: "phone-number",
_17
});
_17
_17
console.log(customerProfilesChannelEndpointAssignment.sid);

Output

_10
{
_10
"sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"customer_profile_sid": "YOUR_BUSINESS_PROFILE_SID",
_10
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"channel_endpoint_sid": "YOUR_PHONE_NUMBER_SID",
_10
"channel_endpoint_type": "phone-number",
_10
"date_created": "2019-07-31T02:34:41Z",
_10
"url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_10
}

  1. Create CNAM Trust Product
  • Note: Do not change the policy_sid from the example below. This is a static value that will stay the same across all accounts.
  • The response will contain the SID for your Trust Product. You'll need this for several other API calls.

Create CNAM Trust Product

create-cnam-trust-product page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_16
// Download the helper library from https://www.twilio.com/docs/node/install
_16
import twilio from "twilio";
_16
_16
// Find your Account SID and Auth Token at twilio.com/console
_16
// and set the environment variables. See http://twil.io/secure
_16
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16
const authToken = process.env.TWILIO_AUTH_TOKEN;
_16
const client = twilio(accountSid, authToken);
_16
_16
const trustProduct = await client.trusthub.v1.trustProducts.create({
_16
email: "EMAIL@EMAIL.COM",
_16
friendlyName: "FRIENDLY_NAME_FOR_YOUR_TRUST_PRODUCT",
_16
policySid: "RNf3db3cd1fe25fcfd3c3ded065c8fea53",
_16
});
_16
_16
console.log(trustProduct.sid);

Output

_19
{
_19
"sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_19
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_19
"policy_sid": "RNf3db3cd1fe25fcfd3c3ded065c8fea53",
_19
"friendly_name": "FRIENDLY_NAME_FOR_YOUR_TRUST_PRODUCT",
_19
"status": "draft",
_19
"email": "EMAIL@EMAIL.COM",
_19
"status_callback": "http://www.example.com",
_19
"valid_until": null,
_19
"date_created": "2019-07-30T22:29:24Z",
_19
"date_updated": "2019-07-31T01:09:00Z",
_19
"url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_19
"links": {
_19
"trust_products_entity_assignments": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments",
_19
"trust_products_evaluations": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Evaluations",
_19
"trust_products_channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments"
_19
},
_19
"errors": null
_19
}

  1. Connect your CNAM Trust Product to your Business Profile

Connect your CNAM Trust Product to your Business Profile

connect-your-cnam-trust-product-to-your-business-profile page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_16
// Download the helper library from https://www.twilio.com/docs/node/install
_16
import twilio from "twilio";
_16
_16
// Find your Account SID and Auth Token at twilio.com/console
_16
// and set the environment variables. See http://twil.io/secure
_16
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16
const authToken = process.env.TWILIO_AUTH_TOKEN;
_16
const client = twilio(accountSid, authToken);
_16
_16
const trustProductsEntityAssignment = await client.trusthub.v1
_16
.trustProducts("YOUR_CNAM_TRUST_PRODUCT_SID")
_16
.trustProductsEntityAssignments.create({
_16
objectSid: "YOUR_BUSINESS_PROFILE_SID",
_16
});
_16
_16
console.log(trustProductsEntityAssignment.sid);

Output

_10
{
_10
"sid": "BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"trust_product_sid": "YOUR_CNAM_TRUST_PRODUCT_SID",
_10
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"object_sid": "YOUR_BUSINESS_PROFILE_SID",
_10
"date_created": "2019-07-31T02:34:41Z",
_10
"url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments/BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_10
}

  1. Create CNAM End User
  • Note: In the API Call below, don't change the Type . It needs to be cnam_information to create the proper CNAM End User resource.
  • This API call will return the SID for the End User . You will need this in the next step.
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_18
// Download the helper library from https://www.twilio.com/docs/node/install
_18
import twilio from "twilio";
_18
_18
// Find your Account SID and Auth Token at twilio.com/console
_18
// and set the environment variables. See http://twil.io/secure
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = twilio(accountSid, authToken);
_18
_18
const endUser = await client.trusthub.v1.endUsers.create({
_18
attributes: {
_18
cnam_display_name: "DISPLAY NAME",
_18
},
_18
friendlyName: "YOUR_END_USER_FRIENDLY_NAME",
_18
type: "cnam_information",
_18
});
_18
_18
console.log(endUser.sid);

Output

_17
{
_17
"date_updated": "2021-02-16T20:40:57Z",
_17
"sid": "ITaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_17
"friendly_name": "YOUR_END_USER_FRIENDLY_NAME",
_17
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_17
"url": "https://trusthub.twilio.com/v1/EndUsers/ITaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_17
"date_created": "2021-02-16T20:40:57Z",
_17
"attributes": {
_17
"phone_number": "+11234567890",
_17
"job_position": "CEO",
_17
"first_name": "rep1",
_17
"last_name": "test",
_17
"business_title": "ceo",
_17
"email": "foobar@test.com"
_17
},
_17
"type": "cnam_information"
_17
}

  1. Connect your CNAM Trust Product to your End User
  • You will need the End User SID from the previous step.
  • You will also need the CNAM Trust Product SID, returned from the API call in Step 3

Connect your CNAM Trust Product to your End User

connect-your-cnam-trust-product-to-your-end-user page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_16
// Download the helper library from https://www.twilio.com/docs/node/install
_16
import twilio from "twilio";
_16
_16
// Find your Account SID and Auth Token at twilio.com/console
_16
// and set the environment variables. See http://twil.io/secure
_16
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16
const authToken = process.env.TWILIO_AUTH_TOKEN;
_16
const client = twilio(accountSid, authToken);
_16
_16
const trustProductsEntityAssignment = await client.trusthub.v1
_16
.trustProducts("YOUR_CNAM_TRUST_PRODUCT_SID")
_16
.trustProductsEntityAssignments.create({
_16
objectSid: "YOUR_CNAM_END_USER_SID",
_16
});
_16
_16
console.log(trustProductsEntityAssignment.sid);

Output

_10
{
_10
"sid": "BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"trust_product_sid": "YOUR_CNAM_TRUST_PRODUCT_SID",
_10
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"object_sid": "YOUR_CNAM_END_USER_SID",
_10
"date_created": "2019-07-31T02:34:41Z",
_10
"url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments/BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_10
}

  1. Add Phone Number to CNAM Trust Product
  • You'll need the CNAM Trust Product SID , returned from the API call in Step 3
  • You'll need the Phone Number SID(s) you assigned to your Business Profile earlier. ( Note: Only those phone numbers already assigned to your Business Profile are eligible)
  • You'll need your Buisness Profile SID . It starts with "BU".
  • To retrieve any of these SIDs via API, see the Additional API Calls section below.
  • Note: Don't change the ChannelEndpointType

Assign Phone Numbers to your CNAM Trust Product

assign-phone-numbers-to-your-cnam-trust-product page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_17
// Download the helper library from https://www.twilio.com/docs/node/install
_17
import twilio from "twilio";
_17
_17
// Find your Account SID and Auth Token at twilio.com/console
_17
// and set the environment variables. See http://twil.io/secure
_17
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_17
const authToken = process.env.TWILIO_AUTH_TOKEN;
_17
const client = twilio(accountSid, authToken);
_17
_17
const trustProductsChannelEndpointAssignment = await client.trusthub.v1
_17
.trustProducts("YOUR_CNAM_TRUST_PRODUCT_SID")
_17
.trustProductsChannelEndpointAssignment.create({
_17
channelEndpointSid: "YOUR_PHONE_NUMBER_SID",
_17
channelEndpointType: "phone-number",
_17
});
_17
_17
console.log(trustProductsChannelEndpointAssignment.sid);

Output

_10
{
_10
"sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"trust_product_sid": "YOUR_CNAM_TRUST_PRODUCT_SID",
_10
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"channel_endpoint_sid": "YOUR_PHONE_NUMBER_SID",
_10
"channel_endpoint_type": "phone-number",
_10
"date_created": "2019-07-31T02:34:41Z",
_10
"url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_10
}

  1. Submit CNAM Trust Product

Submit CNAM Trust Product for Vetting

submit-cnam-trust-product-for-vetting page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const trustProduct = await client.trusthub.v1
_14
.trustProducts("YOUR_CNAM_TRUST_PRODUCT_SID")
_14
.update({ status: "pending-review" });
_14
_14
console.log(trustProduct.sid);

Output

_19
{
_19
"sid": "YOUR_CNAM_TRUST_PRODUCT_SID",
_19
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_19
"policy_sid": "RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_19
"friendly_name": "friendly_name",
_19
"status": "pending-review",
_19
"email": "email",
_19
"status_callback": "http://www.example.com",
_19
"valid_until": null,
_19
"date_created": "2019-07-30T22:29:24Z",
_19
"date_updated": "2019-07-31T01:09:00Z",
_19
"url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_19
"links": {
_19
"trust_products_entity_assignments": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments",
_19
"trust_products_evaluations": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Evaluations",
_19
"trust_products_channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments"
_19
},
_19
"errors": null
_19
}


Learn more about Business Profiles and other Trust Products in the Trust Hub Docs.

(information)

Info

After your CNAM Trust Product reaches "Twilio-Approved", the display name may take 48-72 hours to propagate to all carriers in the United States.

(warning)

Warning

Please note a CNAM display name only appears on devices if enabled by the subscriber and is dependent on the terminating carrier to display the proper registered CNAM.

For landlines, CNAM is always enabled by default.

For mobile devices most commonly, US Carriers require the subscriber to opt-in. If the recipient does not have the CNAM feature or app enabled on their phone no CNAM will display even if a CNAM is properly set for number.

A specific carrier may have outdated CNAM information. For the CNAM to be displayed accurately, the recipient's carrier must query the CNAM databases (LIDB) and update their records. If a carrier has not recently performed a query it may cause the recipient to see outdated CNAM information for the number.


Get Phone Number SIDs from Parent Account

get-phone-number-sids-from-parent-account page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const incomingPhoneNumbers = await client.incomingPhoneNumbers.list({
_14
limit: 20,
_14
});
_14
_14
incomingPhoneNumbers.forEach((i) => console.log(i.accountSid));

Output

_56
{
_56
"end": 0,
_56
"first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0",
_56
"incoming_phone_numbers": [
_56
{
_56
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_56
"address_requirements": "none",
_56
"address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_56
"api_version": "2010-04-01",
_56
"beta": null,
_56
"capabilities": {
_56
"voice": true,
_56
"sms": false,
_56
"mms": true,
_56
"fax": false
_56
},
_56
"date_created": "Thu, 30 Jul 2015 23:19:04 +0000",
_56
"date_updated": "Thu, 30 Jul 2015 23:19:04 +0000",
_56
"emergency_status": "Active",
_56
"emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_56
"emergency_address_status": "registered",
_56
"friendly_name": "(808) 925-5327",
_56
"identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_56
"origin": "origin",
_56
"phone_number": "+18089255327",
_56
"sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_56
"sms_application_sid": "",
_56
"sms_fallback_method": "POST",
_56
"sms_fallback_url": "",
_56
"sms_method": "POST",
_56
"sms_url": "",
_56
"status_callback": "",
_56
"status_callback_method": "POST",
_56
"trunk_sid": null,
_56
"uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
_56
"voice_application_sid": "",
_56
"voice_caller_id_lookup": false,
_56
"voice_fallback_method": "POST",
_56
"voice_fallback_url": null,
_56
"voice_method": "POST",
_56
"voice_url": null,
_56
"bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_56
"voice_receive_mode": "voice",
_56
"status": "in-use",
_56
"subresource_uris": {
_56
"assigned_add_ons": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AssignedAddOns.json"
_56
}
_56
}
_56
],
_56
"next_page_uri": null,
_56
"page": 0,
_56
"page_size": 50,
_56
"previous_page_uri": null,
_56
"start": 0,
_56
"uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0"
_56
}

Check Business Profile Phone Number Assignments

check-business-profile-phone-number-assignments page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const customerProfilesChannelEndpointAssignments = await client.trusthub.v1
_14
.customerProfiles("YOUR_BUSINESS_PROFILE_SID")
_14
.customerProfilesChannelEndpointAssignment.list({ limit: 20 });
_14
_14
customerProfilesChannelEndpointAssignments.forEach((c) => console.log(c.sid));

Output

_22
{
_22
"results": [
_22
{
_22
"sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"channel_endpoint_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"channel_endpoint_type": "phone-number",
_22
"date_created": "2019-07-31T02:34:41Z",
_22
"url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_22
}
_22
],
_22
"meta": {
_22
"page": 0,
_22
"page_size": 50,
_22
"first_page_url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments?ChannelEndpointSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_22
"previous_page_url": null,
_22
"url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments?ChannelEndpointSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_22
"next_page_url": null,
_22
"key": "results"
_22
}
_22
}

Get Business Profile SIDs

get-business-profile-sids page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const customerProfiles = await client.trusthub.v1.customerProfiles.list({
_14
limit: 20,
_14
});
_14
_14
customerProfiles.forEach((c) => console.log(c.sid));

Output

_36
{
_36
"results": [
_36
{
_36
"sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_36
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_36
"policy_sid": "RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_36
"friendly_name": "friendly_name",
_36
"status": "twilio-approved",
_36
"email": "email",
_36
"status_callback": "http://www.example.com",
_36
"valid_until": "2020-07-31T01:00:00Z",
_36
"date_created": "2019-07-30T22:29:24Z",
_36
"date_updated": "2019-07-31T01:09:00Z",
_36
"url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_36
"links": {
_36
"customer_profiles_entity_assignments": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments",
_36
"customer_profiles_evaluations": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Evaluations",
_36
"customer_profiles_channel_endpoint_assignment": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments"
_36
},
_36
"errors": [
_36
{
_36
"code": 18601
_36
}
_36
]
_36
}
_36
],
_36
"meta": {
_36
"page": 0,
_36
"page_size": 50,
_36
"first_page_url": "https://trusthub.twilio.com/v1/CustomerProfiles?Status=draft&FriendlyName=friendly_name&PolicySid=RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_36
"previous_page_url": null,
_36
"url": "https://trusthub.twilio.com/v1/CustomerProfiles?Status=draft&FriendlyName=friendly_name&PolicySid=RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_36
"next_page_url": null,
_36
"key": "results"
_36
}
_36
}

Check Business Profile Phone Number Assignments

check-business-profile-phone-number-assignments-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const customerProfilesChannelEndpointAssignments = await client.trusthub.v1
_14
.customerProfiles("YOUR_BUSINESS_PROFILE_SID")
_14
.customerProfilesChannelEndpointAssignment.list({ limit: 20 });
_14
_14
customerProfilesChannelEndpointAssignments.forEach((c) => console.log(c.sid));

Output

_22
{
_22
"results": [
_22
{
_22
"sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"channel_endpoint_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"channel_endpoint_type": "phone-number",
_22
"date_created": "2019-07-31T02:34:41Z",
_22
"url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_22
}
_22
],
_22
"meta": {
_22
"page": 0,
_22
"page_size": 50,
_22
"first_page_url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments?ChannelEndpointSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_22
"previous_page_url": null,
_22
"url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments?ChannelEndpointSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_22
"next_page_url": null,
_22
"key": "results"
_22
}
_22
}

Fetch Trust Product SIDs

fetch-trust-product-sids page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const trustProducts = await client.trusthub.v1.trustProducts.list({
_14
limit: 20,
_14
});
_14
_14
trustProducts.forEach((t) => console.log(t.sid));

Output

_32
{
_32
"results": [
_32
{
_32
"sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_32
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_32
"policy_sid": "RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_32
"friendly_name": "friendly_name",
_32
"status": "twilio-approved",
_32
"email": "email",
_32
"status_callback": "http://www.example.com",
_32
"valid_until": "2020-07-31T01:00:00Z",
_32
"date_created": "2019-07-30T22:29:24Z",
_32
"date_updated": "2019-07-31T01:09:00Z",
_32
"url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_32
"links": {
_32
"trust_products_entity_assignments": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments",
_32
"trust_products_evaluations": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Evaluations",
_32
"trust_products_channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments"
_32
},
_32
"errors": null
_32
}
_32
],
_32
"meta": {
_32
"page": 0,
_32
"page_size": 50,
_32
"first_page_url": "https://trusthub.twilio.com/v1/TrustProducts?Status=draft&FriendlyName=friendly_name&PolicySid=RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_32
"previous_page_url": null,
_32
"url": "https://trusthub.twilio.com/v1/TrustProducts?Status=draft&FriendlyName=friendly_name&PolicySid=RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_32
"next_page_url": null,
_32
"key": "results"
_32
}
_32
}

Check CNAM Phone Number Assignments

check-cnam-phone-number-assignments page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const trustProductsChannelEndpointAssignments = await client.trusthub.v1
_14
.trustProducts("YOUR_CNAM_TRUST_PRODUCT_SID")
_14
.trustProductsChannelEndpointAssignment.list({ limit: 20 });
_14
_14
trustProductsChannelEndpointAssignments.forEach((t) => console.log(t.sid));

Output

_22
{
_22
"results": [
_22
{
_22
"sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"trust_product_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"channel_endpoint_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22
"channel_endpoint_type": "phone-number",
_22
"date_created": "2019-07-31T02:34:41Z",
_22
"url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_22
}
_22
],
_22
"meta": {
_22
"page": 0,
_22
"page_size": 50,
_22
"first_page_url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments?ChannelEndpointSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_22
"previous_page_url": null,
_22
"url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments?ChannelEndpointSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
_22
"next_page_url": null,
_22
"key": "results"
_22
}
_22
}


Rate this page: