Phone Number Assignment

Phone Number Assignment

After your campaign is approved, the final step is assigning your US phone numbers to it. Messages sent from assigned numbers will be delivered as registered A2P traffic with higher deliverability.

Prerequisites

Before assigning phone numbers:

1. Approved Campaign - Your campaign must be approved (see Campaign Registration)
2. US Phone Number - At least one active US phone number in your account

How to Assign Numbers

Via Dashboard

1. Navigate to Phone Numbers in your Dashboard
2. Find the phone number you want to assign
3. Click on the phone number to open details
4. Select the approved campaign from the dropdown
5. Save changes

Via API

terminalCopy
# Assign a phone number to an approved campaign
curl -X POST https://api.zavu.dev/v1/10dlc/campaigns/{campaignId}/phone-numbers \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumberId": "pn_abc123"
  }'

# List phone numbers assigned to a campaign
curl https://api.zavu.dev/v1/10dlc/campaigns/{campaignId}/phone-numbers \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

# Remove a phone number from a campaign
curl -X DELETE https://api.zavu.dev/v1/10dlc/campaigns/{campaignId}/phone-numbers/{assignmentId} \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

Each assignment has a status: pending (sent to the carrier, not confirmed yet), active (the number is on the campaign and can send) or failed (the carrier refused it; see failureReason). The list paginates with limit and cursor like every other list, and a number that was unassigned is no longer listed.

Assignment Rules

After Assignment

Once a phone number is assigned to an approved campaign:

• Immediate effect - Messages are sent as registered A2P traffic
• Higher throughput - Benefit from your Trust Score limits
• Better deliverability - Carrier filtering is reduced
• Compliance tracking - Messages are associated with your campaign

Managing Assignments

Reassigning Numbers

To move a phone number to a different campaign:

1. Open the phone number details
2. Select the new campaign
3. Save changes

Removing Assignment

To remove a phone number from a campaign:

1. Open the phone number details
2. Clear the campaign selection
3. Save changes

Troubleshooting

Number not appearing for assignment

• Verify the phone number is a US number
• Check the phone number status is active
• Ensure you have an approved campaign

Assignment not taking effect

• Wait a few minutes for carrier propagation
• Verify the campaign is still approved
• Check your account balance for any issues

Low throughput after assignment

Your throughput is determined by your brand's Trust Score:

Best Practices

1. Dedicated numbers per use case - Use separate numbers for different message types
2. Geographic distribution - Use local area codes when possible
3. Monitor delivery rates - Track message delivery in your dashboard
4. Keep campaigns updated - Update sample messages if your content changes

Summary

The complete 10DLC registration flow:

CodeCopy
1. Complete Business Verification (KYB)
         ↓
2. Register Brand ($4 one-time) → Wait for approval (1-3 days)
         ↓
3. Create Campaign ($15 one-time + $10/month) → Wait for approval (1-7 days)
         ↓
4. Assign Phone Numbers → Ready to send!