Voice Integrity Onboarding with the Trust Hub REST API (Direct Customers, no Subaccounts)

Learn to create and submit a Voice Integrity Trust Product by using the Twilio Trust Hub REST API to send POST requests to various Trust Hub resource endpoints. You can use this guide to send voice notifications, create self-service automation, create an outbound call center, and create transcriptions for AI or ML.

See Related reference documentation to learn more about the Trust Hub REST API used in this guide.

This page walks Direct Customers with no subaccounts through creating a Voice Integrity Trust Product with the Trust Hub REST API.

Not a Direct Customer with no subaccounts? Find the appropriate onboarding instructions below:

Direct customers (no subaccounts)

Flowchart of voice integrity with parent account, subaccounts, business profiles, and end user identity.

Create a Primary Business Profile in your Parent Account in Trust Hub and submit for vetting

In Twilio Console, go to Trust Hub > Customer Profiles or Customer Profiles in the legacy Console to create your profile.
You will only need to do this one time.
To learn more about Business Profiles and vetting, go to the Trust Hub Docs.

Add Phone Number(s) to your Primary Business Profile

This is required before you can add a phone number to your Voice Integrity Trust Product.
You'll need your Business Profile's SID,
- To find your Business Profile SID in the Console, go to Trust Hub > Profiles.
- If you'd prefer to look up your Business Profile SID using the API, see the Additional API Calls section.
- Business Profile SIDs begin with "BU".
You'll also need your Phone Number SID(s)
- To find your Phone Number SIDs in the Console, go to Numbers & senders. Select your phone number to find the SID.
- To find your Phone Number SIDs using the API, see the Additional API Calls Section.
- 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.

3. Create a Voice Integrity Trust Product

Note: Don't change the PolicySid from the example below.
The response will contain the SID for your Trust Product. You'll need this for the next step.

Create Voice Integrity Trust Product

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function createTrustProduct() {
11  const trustProduct = await client.trusthub.v1.trustProducts.create({
12    email: "EMAIL@EXAMPLE.COM",
13    friendlyName: "FRIENDLY_NAME_FOR_YOUR_TRUST_PRODUCT",
14    policySid: "RN5b3660f9598883b1df4e77f77acefba0",
15  });
16
17  console.log(trustProduct.sid);
18}
19
20createTrustProduct();

Response

1{
2  "sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4  "policy_sid": "RN5b3660f9598883b1df4e77f77acefba0",
5  "friendly_name": "FRIENDLY_NAME_FOR_YOUR_TRUST_PRODUCT",
6  "status": "draft",
7  "email": "EMAIL@EXAMPLE.COM",
8  "status_callback": "http://www.example.com",
9  "valid_until": null,
10  "date_created": "2019-07-30T22:29:24Z",
11  "date_updated": "2019-07-31T01:09:00Z",
12  "url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
13  "links": {
14    "trust_products_entity_assignments": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments",
15    "trust_products_evaluations": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Evaluations",
16    "trust_products_channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments"
17  },
18  "errors": null
19}

4. Create End User for the Voice Integrity Trust Product

Information you will need:
- Use Case
  - Possible Values: Identify & Verification,Asset Management,Lead Generation,Intelligent Routing,Appointment Scheduling,Customer Support,Self-Service,Automated Support,Appointment Reminders,Employee Notifications,Delivery Notifications,Emergency Notifications,Contactless Delivery,Order Notifications,Service Alerts,Purchase Confirmation,Mass Alerts,Fraud Alerts,Contact Tracing,Lead Management,Lead Nurturing,Telemarketing,Marketing Events,Rewards Program,Lead Alerts,Lead Distribution,Abandoned Cart,Call Tracking,Outbound Dialer,Click to Call,Phone System,Meetings/Collaboration,Telehealth,Distance Learning,Shift Management,Field Notifications,Dating/Social,Remote appointments,Group Messaging,Exam Proctoring,Tutoring,Therapy (Individual+Group),Pharmacy,First Responder,Survey/Research
- Business Employee count
  - The should be the number of employees in the business
- Average Business Day Call Volume
  - This should be an estimate of number of calls per business day.
- Notes
  - This may be any additional notes about the use case. For example "We do lost mile delivery of goods". This can be empty if there are no additional notes.
Note: Don't change the type from the example below.
The response will contain the SID for your End User. You'll need this for the next step.

Create an End User for the Voice Integrity Trust Product

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function createEndUser() {
11  const endUser = await client.trusthub.v1.endUsers.create({
12    attributes: {
13      use_case: "Survey/Research",
14      business_employee_count: "10",
15      average_business_day_call_volume: "10",
16      notes: "Surveying people to learn about demographics",
17    },
18    friendlyName: "YOUR_END_USER_FRIENDLY_NAME",
19    type: "voice_integrity_information",
20  });
21
22  console.log(endUser.sid);
23}
24
25createEndUser();

Response

1{
2  "date_updated": "2021-02-16T20:40:57Z",
3  "sid": "ITaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4  "friendly_name": "YOUR_END_USER_FRIENDLY_NAME",
5  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
6  "url": "https://trusthub.twilio.com/v1/EndUsers/ITaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
7  "date_created": "2021-02-16T20:40:57Z",
8  "attributes": {
9    "use_case": "Survey/Research",
10    "business_employee_count": "10",
11    "average_business_day_call_volume": "10",
12    "notes": "Surveying people to learn about demographics"
13  },
14  "type": "voice_integrity_information"
15}

5. Connect your Voice Integrity Trust Product to End User

You'll need your Trust Product's SID. This was returned by the API call in step 3.
You'll need your End User SID. This is the SID that starts with "IT" was returned in the previous API call.
To retrieve these SIDs using the the API, see the Additional API Calls section below. You can also find them in the Console under Trust Hub.

Connect your Voice Integrity Trust Product to End User

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function createTrustProductEntityAssignment() {
11  const trustProductsEntityAssignment = await client.trusthub.v1
12    .trustProducts("YOUR_TRUST_PRODUCT_SID")
13    .trustProductsEntityAssignments.create({ objectSid: "YOUR_END_USER_SID" });
14
15  console.log(trustProductsEntityAssignment.sid);
16}
17
18createTrustProductEntityAssignment();

Response

1{
2  "sid": "BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "trust_product_sid": "YOUR_TRUST_PRODUCT_SID",
4  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5  "object_sid": "YOUR_END_USER_SID",
6  "date_created": "2019-07-31T02:34:41Z",
7  "url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments/BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
8}

Connect your Voice Integrity Trust Product to your Business Profile

You'll need your Trust Product's SID. This was returned by the API call in step 3.
You'll need your Business Profile's SID. This is the SID that starts with "BU" you used earlier.
To retrieve these SIDs using the the API, see the Additional API Calls section below. You can also find them in the Console under Trust Hub.

Connect your Voice Integrity Trust Product to your Business Profile

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function createTrustProductEntityAssignment() {
11  const trustProductsEntityAssignment = await client.trusthub.v1
12    .trustProducts("YOUR_TRUST_PRODUCT_SID")
13    .trustProductsEntityAssignments.create({
14      objectSid: "YOUR_BUSINESS_PROFILE_SID",
15    });
16
17  console.log(trustProductsEntityAssignment.sid);
18}
19
20createTrustProductEntityAssignment();

Response

1{
2  "sid": "BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "trust_product_sid": "YOUR_TRUST_PRODUCT_SID",
4  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5  "object_sid": "YOUR_BUSINESS_PROFILE_SID",
6  "date_created": "2019-07-31T02:34:41Z",
7  "url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments/BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
8}

Assign phone numbers to your Voice Integrity Trust Product

You'll need the Phone Number SID(s) you assigned to your Business Profile earlier. (Note: Only those phone numbers already assigned to your Primary Business Profile are eligible)
You'll need your Trust Product SID used earlier.
Don't change the ChannelEndpointType
You can complete this step before or after submitting your Voice Integrity Trust Product
To check your Business Profile's phone numbers using the API, see the Additional API Calls section below.

Assign Phone Numbers to Voice Integrity Trust Product

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function createTrustProductChannelEndpointAssignment() {
11  const trustProductsChannelEndpointAssignment = await client.trusthub.v1
12    .trustProducts("YOUR_TRUST_PRODUCT_SID")
13    .trustProductsChannelEndpointAssignment.create({
14      channelEndpointSid: "YOUR_PHONE_NUMBER_SID",
15      channelEndpointType: "phone-number",
16    });
17
18  console.log(trustProductsChannelEndpointAssignment.sid);
19}
20
21createTrustProductChannelEndpointAssignment();

Response

1{
2  "sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "trust_product_sid": "YOUR_TRUST_PRODUCT_SID",
4  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5  "channel_endpoint_sid": "YOUR_PHONE_NUMBER_SID",
6  "channel_endpoint_type": "phone-number",
7  "date_created": "2019-07-31T02:34:41Z",
8  "url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
9}

Submit your Voice Integrity Trust Product

Approval and registration of Phone Numbers may take 24 to 48 hours.

Submit Voice Integrity Trust Product for Vetting

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function updateTrustProduct() {
11  const trustProduct = await client.trusthub.v1
12    .trustProducts("YOUR_TRUST_PRODUCT_SID")
13    .update({ status: "pending-review" });
14
15  console.log(trustProduct.sid);
16}
17
18updateTrustProduct();

Response

1{
2  "sid": "YOUR_TRUST_PRODUCT_SID",
3  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4  "policy_sid": "RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5  "friendly_name": "friendly_name",
6  "status": "pending-review",
7  "email": "notification@email.com",
8  "status_callback": "http://www.example.com",
9  "valid_until": null,
10  "date_created": "2019-07-30T22:29:24Z",
11  "date_updated": "2019-07-31T01:09:00Z",
12  "url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
13  "links": {
14    "trust_products_entity_assignments": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments",
15    "trust_products_evaluations": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Evaluations",
16    "trust_products_channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments"
17  },
18  "errors": null
19}

Additional API calls

Get Business Profile SID

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function listCustomerProfile() {
11  const customerProfiles = await client.trusthub.v1.customerProfiles.list({
12    limit: 20,
13  });
14
15  customerProfiles.forEach((c) => console.log(c.sid));
16}
17
18listCustomerProfile();

Response

1{
2  "results": [
3    {
4      "sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
6      "policy_sid": "RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
7      "friendly_name": "friendly_name",
8      "status": "twilio-approved",
9      "email": "notification@email.com",
10      "status_callback": "http://www.example.com",
11      "valid_until": "2020-07-31T01:00:00Z",
12      "date_created": "2019-07-30T22:29:24Z",
13      "date_updated": "2019-07-31T01:09:00Z",
14      "url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
15      "links": {
16        "customer_profiles_entity_assignments": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments",
17        "customer_profiles_evaluations": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Evaluations",
18        "customer_profiles_channel_endpoint_assignment": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments"
19      },
20      "errors": [
21        {
22          "code": 18601
23        }
24      ]
25    }
26  ],
27  "meta": {
28    "page": 0,
29    "page_size": 50,
30    "first_page_url": "https://trusthub.twilio.com/v1/CustomerProfiles?Status=draft&FriendlyName=friendly_name&PolicySid=RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
31    "previous_page_url": null,
32    "url": "https://trusthub.twilio.com/v1/CustomerProfiles?Status=draft&FriendlyName=friendly_name&PolicySid=RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
33    "next_page_url": null,
34    "key": "results"
35  }
36}

Get Phone Number SIDs from Parent Account

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function listIncomingPhoneNumber() {
11  const incomingPhoneNumbers = await client.incomingPhoneNumbers.list({
12    limit: 20,
13  });
14
15  incomingPhoneNumbers.forEach((i) => console.log(i.end));
16}
17
18listIncomingPhoneNumber();

Response

1{
2  "end": 0,
3  "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0",
4  "incoming_phone_numbers": [
5    {
6      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
7      "address_requirements": "none",
8      "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
9      "api_version": "2010-04-01",
10      "beta": null,
11      "capabilities": {
12        "voice": true,
13        "sms": false,
14        "mms": true,
15        "fax": false
16      },
17      "date_created": "Thu, 30 Jul 2015 23:19:04 +0000",
18      "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000",
19      "emergency_status": "Active",
20      "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
21      "emergency_address_status": "registered",
22      "friendly_name": "(808) 925-5327",
23      "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
24      "origin": "origin",
25      "phone_number": "+18089255327",
26      "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
27      "sms_application_sid": "",
28      "sms_fallback_method": "POST",
29      "sms_fallback_url": "",
30      "sms_method": "POST",
31      "sms_url": "",
32      "status_callback": "",
33      "status_callback_method": "POST",
34      "trunk_sid": null,
35      "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
36      "voice_application_sid": "",
37      "voice_caller_id_lookup": false,
38      "voice_fallback_method": "POST",
39      "voice_fallback_url": null,
40      "voice_method": "POST",
41      "voice_url": null,
42      "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
43      "voice_receive_mode": "voice",
44      "status": "in-use",
45      "type": "local"
46    }
47  ],
48  "next_page_uri": null,
49  "page": 0,
50  "page_size": 50,
51  "previous_page_uri": null,
52  "start": 0,
53  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0"
54}

Get Trust Product SIDs

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function listTrustProduct() {
11  const trustProducts = await client.trusthub.v1.trustProducts.list({
12    limit: 20,
13  });
14
15  trustProducts.forEach((t) => console.log(t.sid));
16}
17
18listTrustProduct();

Response

1{
2  "results": [
3    {
4      "sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
6      "policy_sid": "RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
7      "friendly_name": "friendly_name",
8      "status": "twilio-approved",
9      "email": "notification@email.com",
10      "status_callback": "http://www.example.com",
11      "valid_until": "2020-07-31T01:00:00Z",
12      "date_created": "2019-07-30T22:29:24Z",
13      "date_updated": "2019-07-31T01:09:00Z",
14      "url": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
15      "links": {
16        "trust_products_entity_assignments": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/EntityAssignments",
17        "trust_products_evaluations": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Evaluations",
18        "trust_products_channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments"
19      },
20      "errors": null
21    }
22  ],
23  "meta": {
24    "page": 0,
25    "page_size": 50,
26    "first_page_url": "https://trusthub.twilio.com/v1/TrustProducts?Status=draft&FriendlyName=friendly_name&PolicySid=RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
27    "previous_page_url": null,
28    "url": "https://trusthub.twilio.com/v1/TrustProducts?Status=draft&FriendlyName=friendly_name&PolicySid=RNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
29    "next_page_url": null,
30    "key": "results"
31  }
32}

Check Business Profile Phone Number Assignments

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function listCustomerProfileChannelEndpointAssignment() {
11  const customerProfilesChannelEndpointAssignments = await client.trusthub.v1
12    .customerProfiles("YOUR_BUSINESS_PROFILE_SID")
13    .customerProfilesChannelEndpointAssignment.list({ limit: 20 });
14
15  customerProfilesChannelEndpointAssignments.forEach((c) => console.log(c.sid));
16}
17
18listCustomerProfileChannelEndpointAssignment();

Response

1{
2  "results": [
3    {
4      "sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5      "customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
6      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
7      "channel_endpoint_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
8      "channel_endpoint_type": "phone-number",
9      "date_created": "2019-07-31T02:34:41Z",
10      "url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
11    }
12  ],
13  "meta": {
14    "page": 0,
15    "page_size": 50,
16    "first_page_url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments?ChannelEndpointSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
17    "previous_page_url": null,
18    "url": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments?ChannelEndpointSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
19    "next_page_url": null,
20    "key": "results"
21  }
22}

Use cases for Voice Integrity Onboarding with Twilio Programmable Voice

This guide teaches the basics required for the following use cases:

Send voice notifications with Twilio Programmable Voice

You can use this guide to register your business profile and actively monitor your numbers for accurate reputation status across major U.S. carriers. Voice Integrity provides analytics to catch and fix sudden spam labels instantly, ensuring critical alerts and emergency weather closures reach your customers with trusted caller identification. To learn more advanced features that you can use with voice notifications, see Voice notifications.

Create an outbound contact center with Twilio Programmable Voice

You can use this guide to implement a centralized remediation workflow directly from the Twilio Console when outbound call volume spikes trigger false positives. Voice Integrity lets you appealing spam tags across carrier ecosystems simultaneously, restoring high connection rates and keeping contact center outreach unblocked. To learn more advanced features that you can use with outbound call centers, see Voice outbound contact center.

Build a sales dialer with Twilio Programmable Voice

You can use this guide to proactively safeguard your outbound numbers from damaging "Spam Likely" labels that kill conversion rates. By using Voice Integrity to establish a verified reputation profile, you gain visibility into how carriers score your phone lines, ensuring prospects see a trust indicator instead of a spam warning when sales reps call. To learn more advanced features that you can use with sales dialers, see Voice sales dialer.

Build AI agents with Twilio Programmable Voice

You can use this guide to ensure your automated conversational voice agents are not proactively blocked by mobile networks before they can even speak. Voice Integrity lets you monitor and manage the reputation of the phone lines assigned to your virtual assistants, keeping outbound AI customer interactions labeled as trusted rather than flagged as robotic spam. To learn more advanced features that you can use with AI agents, see Voice AI agents.

Result

After following this guide, you can successfully onboard your direct customer parent account into the Twilio Trust Hub using REST API operations. Your Voice Integrity Trust Product will be submitted for evaluation, protecting your outbound calls and preventing your phone numbers from getting incorrectly labeled as spam.

Next steps

Explore the following guides to build on what you've learned in this guide:

Branded Calling: Brand your calls with business identity indicators.
SHAKEN/STIR: Learn how to use SHAKEN/STIR to protect your calls from being labeled as spam.