Attach Campaign | Pinnacle

1 import { PinnacleClient } from "rcs-js"; 2 3 async function main() { 4 const client = new PinnacleClient({ 5 environment: "https://api.pinnacle.sh", 6 }); 7 await client.phoneNumbers.campaign.attach({ 8 phones: [ 9 "+14155550123", 10 "+14155559876", 11 "+14155550111", 12 ], 13 campaignType: "TOLL_FREE", 14 campaignId: "tf_1234567890", 15 }); 16 } 17 main();

1 { 2 "phoneNumbers": [ 3 { 4 "phoneNumber": "+14155550123", 5 "campaign": { 6 "id": "dlc_1234567890", 7 "name": "Summer Promo", 8 "type": "10DLC" 9 } 10 }, 11 { 12 "phoneNumber": "+14155559876", 13 "campaign": { 14 "id": "dlc_1234567891", 15 "name": "Winter Blast", 16 "type": "10DLC" 17 } 18 } 19 ], 20 "failed": [ 21 { 22 "number": "+14155550111", 23 "error": "Number is not available. Make sure your team owns this number and it is not a sandbox number." 24 } 25 ] 26 }

Link a phone number to a specific campaign. Phone numbers must be linked to a campaign to send messages.

Authentication

PINNACLE-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

phoneslist of stringsRequired

List of phone number (E.164 format).

campaignTypeenumRequired

Type of messaging profile associated with the phone number.

Allowed values:

campaignIdstringRequired

Unique identifier for the campaign.

TOLL_FREE campaigns:
- Must begin with the prefix tf_
- Example: tf_1234567890
10DLC campaigns:
- Must begin with the prefix dlc_
- Example: dlc_1234567890

Unique identifier for the campaign. <br> - **TOLL_FREE** campaigns: - Must begin with the prefix `tf_` - Example: `tf_1234567890` - **10DLC** campaigns: - Must begin with the prefix `dlc_` - Example: `dlc_1234567890`

Response

Successfully attached the campaign.

phoneNumberslist of objects

List of phone numbers.

failedlist of objects

List of numbers that were not failed to be attached.

Authentication

Request

Response

Errors