Setting up Telnyx messaging profiles and 10DLC

See also

Sources

1. 1
   Telnyx 10DLC API endpoints: POST /v2/10dlc/brand creates a brand, POST /v2/10dlc/brand/{brandId}/vetting requests vetting, POST /v2/10dlc/campaignBuilder creates a campaign, and POST /v2/10dlc/phoneNumberCampaign assigns a number.

   10DLC Getting Started · 10DLC Getting Started, API endpoints table · Checked 2026-10-14
2. 2
   Telnyx's 10DLC sequence is: create a brand (registered with The Campaign Registry), vet the brand, create a campaign, then assign phone numbers to the campaign.

   10DLC Getting Started · 10DLC Getting Started, Registration overview steps 1-4 · Checked 2026-10-14
3. 3
   Telnyx caps a 10DLC campaign at 49 numbers because of T-Mobile limits; going beyond 49 needs a T-Mobile Number Pool Request form, which carries additional charges.

   How to assign a number to a campaign · How to assign a number to a campaign, number limits paragraph · Checked 2026-10-14
4. 4
   Since 1 March 2024, creating or editing a Telnyx Messaging or Verify profile in the Portal or API requires whitelisted destination countries for outbound termination; existing profiles are unaffected until edited.

   Setting Up a Messaging Profile · Setting Up a Messaging Profile, section 'Messaging Profile Updates - 1st March 2024' · Checked 2026-10-14
5. 5
   Since 1 March 2024, Telnyx requires a default alphanumeric sender ID on the messaging profile for messages sent to non-US destinations.

   Setting Up a Messaging Profile · Setting Up a Messaging Profile, section 'Messaging Profile Updates - 1st March 2024' · Checked 2026-10-14
6. 6
   POST /messaging_profiles in the Telnyx API requires name and whitelisted_destinations in the request body.

   Create a messaging profile · Create a messaging profile, request body, required fields · Checked 2026-10-14
7. 7
   Telnyx lists a campaign's numbers with GET /v2/10dlc/phoneNumberCampaign?filter[campaignId]=... and removes one with DELETE /v2/10dlc/phoneNumberCampaign/{phoneNumber}, after which that number can no longer send 10DLC messages.

   10DLC Phone Number Assignment · 10DLC Phone Number Assignment, List Assigned Numbers and Remove a Number · Checked 2026-10-14
8. 8
   Telnyx's developer guide describes portal campaign assignment as: Campaigns, select the campaign, Assign Numbers panel, choose the messaging profile, add numbers, Assign.

   10DLC Phone Number Assignment · 10DLC Phone Number Assignment, Assign a Number, portal steps · Checked 2026-10-14
9. 9
   Telnyx's help article describes portal campaign assignment as: Messaging > 10DLC Campaigns, select the approved campaign, Phone Numbers tab, select numbers, Assign to Campaign, then wait for the status to change from PENDING to ASSIGNED.

   How to assign a number to a campaign · How to assign a number to a campaign, portal steps 1-4 · Checked 2026-10-14
10. 10
    Before a number can join a Telnyx 10DLC campaign, it must be a US 10-digit long code already on a messaging profile, and the campaign must be ACTIVE (carrier-approved).

    10DLC Phone Number Assignment · 10DLC Phone Number Assignment, Requirements · Checked 2026-10-14
11. 11
    Through the API, a number is attached to a Telnyx messaging profile with PATCH /v2/messaging_phone_numbers/{phone_number} and a messaging_profile_id in the body.

    Phone Number Messaging Configuration · Phone Number Messaging Configuration, assign section · Checked 2026-10-14
12. 12
    In the Telnyx portal a number is attached to a messaging profile from My Numbers by editing the number's Messaging Profile column, choosing the profile and accepting the listed cost changes.

    Setting Up a Messaging Profile · Setting Up a Messaging Profile, assigning the profile to a number, steps 1-4 · Checked 2026-10-14
13. 13
    Telnyx's help article says assigning a number to a 10DLC campaign typically takes about 2 hours and can range from minutes to a few days.disputed

    How to assign a number to a campaign · How to assign a number to a campaign, timing paragraph · Checked 2026-10-14
14. 14
    Telnyx's 10DLC quickstart timeline lists number assignment to a campaign as instant.disputed

    10DLC Getting Started · 10DLC Getting Started, timelines table, Assign numbers row · Checked 2026-10-14
15. 15
    Per Telnyx, AT&T assigns 10DLC throughput per campaign by message class: standard campaigns get 4,500 SMS per minute at scores 75-100, 2,400 at 50-74 and 240 at 1-49; low-volume mixed (class T) gets 75 and sole proprietor (class W) gets 15.

    10DLC Rate Limits · 10DLC Rate Limits, AT&T section, standard and special use-case tables · Checked 2026-10-14
16. 16
    Telnyx allows only one 10DLC brand per EIN, and the legal company name must match IRS records for that EIN.

    10DLC Brand Registration · 10DLC Brand Registration, required fields / EIN notes · Checked 2026-10-14
17. 17
    On Telnyx, campaigns can be created before brand vetting finishes, but throughput stays limited until a vetting score is assigned.

    10DLC Getting Started · 10DLC Getting Started, Step 2: Vet your brand · Checked 2026-10-14
18. 18
    Telnyx 10DLC campaign status runs TCR_PENDING, TCR_ACCEPTED, MNO_PENDING, MNO_PROVISIONED on success; failure or suspension states are TCR_FAILED, TELNYX_FAILED, MNO_REJECTED, TCR_SUSPENDED and TCR_EXPIRED.

    10DLC Event Notification Webhooks · 10DLC Event Notification Webhooks, campaign status values · Checked 2026-10-14
19. 19
    A Telnyx 10DLC campaign requires brandId, usecase, description, sample1, sample2, messageFlow, helpMessage, optinKeywords, optoutKeywords and helpKeywords.

    10DLC Campaign Registration · 10DLC Campaign Registration, required fields · Checked 2026-10-14
20. 20
    After TCR approval, Telnyx says each carrier provisions a 10DLC campaign independently: T-Mobile instant to 24 hours, AT&T and Verizon 1-3 business days, US Cellular 3-5 business days.

    10DLC Campaign Registration · 10DLC Campaign Registration, carrier approval timeline · Checked 2026-10-14
21. 21
    Telnyx lists registered 10DLC carrier SMS fees of $0.003 per sent message on AT&T, $0.003 per sent or received message on T-Mobile, and $0.0045 per sent message on Verizon Wireless.

    10DLC Fees and Charges · 10DLC Fees and Charges, per-message carrier fees for registered traffic · Checked 2026-10-14
22. 22
    Telnyx 10DLC send error 40300 means the number is not registered for 10DLC, and the fix is to assign the sending number to an approved campaign.

    10DLC Troubleshooting · 10DLC Troubleshooting, error code table, 40300 · Checked 2026-10-14
23. 23
    Telnyx 10DLC status webhooks are configured as webhookURL (with optional webhookFailoverURL) on the brand and on the campaign; phone-number events use the campaign's webhooks and have no setting of their own.

    10DLC Event Notification Webhooks · 10DLC Event Notification Webhooks, where the webhook URL is set · Checked 2026-10-14
24. 24
    Telnyx charges a one-time $4.50 10DLC brand registration fee.

    10DLC Fees and Charges · 10DLC Fees and Charges, brand and campaign fee table · Checked 2026-10-14
25. 25
    Telnyx charges $15 for each 10DLC campaign review (vetting), and resubmitting after a denial may incur further charges.

    10DLC Fees and Charges · 10DLC Fees and Charges, brand and campaign fee table · Checked 2026-10-14
26. 26
    Telnyx's 10DLC monthly campaign fees as of 22 July 2025: standard $10, low-volume mixed $1.50, charity $3, emergency $5, agents and franchises $30, sole proprietor $2.

    10DLC Fees and Charges · 10DLC Fees and Charges, 'TCR Fees as of 7/22/2025' schedule · Checked 2026-10-14
27. 27
    Telnyx bills 10DLC campaign fees for three months at first, then monthly, and passes 10DLC fees through at cost with no markup.

    10DLC Fees and Charges · 10DLC Fees and Charges, billing and pass-through notes · Checked 2026-10-14
28. 28
    Telnyx delivers inbound messages to an application only through a webhook URL configured in the messaging profile's Inbound Settings.

    Setting Up a Messaging Profile · Setting Up a Messaging Profile, Inbound Settings step · Checked 2026-10-14
29. 29
    An ISV whose campaigns are registered with an upstream CSP shares each approved campaign to Telnyx, finds it in the Partner Campaigns API by tcrCampaignId, and may assign numbers and send traffic only once the sharing status is ACCEPTED.

    ISV & Reseller 10DLC Onboarding · ISV & Reseller 10DLC Onboarding, shared campaigns and steps 4-6 · Checked 2026-10-14
30. 30
    Since 26 January 2023, all new Telnyx US 10DLC campaign registrations (standard, low-volume standard and sole proprietor) go through manual vetting.

    10DLC Campaign Approval Best Practices · 10DLC Campaign Approval Best Practices, opening paragraph · Checked 2026-10-14
31. 31
    Every Telnyx phone number used for messaging must be assigned to a messaging profile.

    Messaging Profiles Overview · Messaging Profiles Overview, section on assigning phone numbers · Checked 2026-10-14
32. 32
    When number pool is enabled on a Telnyx messaging profile, outbound messages are distributed automatically across all numbers assigned to the profile.

    Messaging Profiles Overview · Messaging Profiles Overview, Number Pool · Checked 2026-10-14
33. 33
    A Telnyx number can belong to only one 10DLC campaign at a time; moving it means deleting the existing assignment and then assigning it to the new campaign.

    10DLC Phone Number Assignment · 10DLC Phone Number Assignment, Requirements and Troubleshooting (already assigned) · Checked 2026-10-14
34. 34
    Telnyx requires opt-in wording at every phone-number collection point, including consent, opt-out instructions and links to the privacy policy and terms, and at least one sample message must carry opt-out language such as reply STOP.

    10DLC Campaign Approval Best Practices · 10DLC Campaign Approval Best Practices, opt-in and sample messages sections · Checked 2026-10-14
35. 35
    Every number in a Telnyx number pool must be assigned to the same 10DLC campaign; carriers filter messages sent from unassigned pool numbers.

    10DLC Phone Number Assignment · 10DLC Phone Number Assignment, Number Pools · Checked 2026-10-14
36. 36
    Telnyx guides show more than one API route for attaching a number to a messaging profile (PATCH /v2/messaging_phone_numbers/{phone_number}, PATCH /v2/phone_numbers/{number} with messaging_profile_id, and POST /v2/messaging_profiles/{profile_id}/phone_numbers), so integrators should confirm the current route against the API reference.inferred

    Phone Number Messaging Configuration · Phone Number Messaging Configuration, assign section; compare 10DLC Phone Number Assignment, Troubleshooting; Messaging Profiles Overview, number assignment · Checked 2026-10-14
37. 37
    A Telnyx messaging profile is the central messaging configuration object: it groups phone numbers, defines webhook URLs and controls features such as number pooling, smart encoding and spend limits.

    Messaging Profiles Overview · Messaging Profiles Overview, opening section · Checked 2026-10-14
38. 38
    In the Telnyx Mission Control Portal, a messaging profile is created from the Programmable Messaging tab with Add New Profile; new users see a Create your first profile prompt instead.

    Setting Up a Messaging Profile · Setting Up a Messaging Profile, creation steps 1 · Checked 2026-10-14
39. 39
    If messages are still filtered after assignment, Telnyx advises allowing 24-72 hours for carrier propagation and checking per-carrier status in the campaign's MNO metadata.

    10DLC Phone Number Assignment · 10DLC Phone Number Assignment, Troubleshooting, messages still filtered · Checked 2026-10-14
40. 40
    On Telnyx, a US long code is ready for messaging only after 10DLC brand and campaign registration, while US and Canadian toll-free numbers need toll-free verification instead.

    Phone Number Messaging Configuration · Phone Number Messaging Configuration, readiness by number type table · Checked 2026-10-14
41. 41
    A rejected Telnyx 10DLC campaign cannot be edited: the sender fixes the issues, creates a new campaign (which incurs another registration fee) and reassigns numbers to it.

    10DLC Campaign Registration · 10DLC Campaign Registration, resubmission · Checked 2026-10-14
42. 42
    Telnyx identifies poorly written sample messages as the most common reason 10DLC campaigns are rejected; carriers review samples by hand against the declared use case.

    10DLC Campaign Registration · 10DLC Campaign Registration, sample messages · Checked 2026-10-14
43. 43
    A Telnyx sole proprietor 10DLC brand may have one active campaign with one phone number, and is verified by an SMS OTP to a US or Canadian mobile number that expires after 24 hours.

    Sole Proprietor 10DLC Registration · Sole Proprietor 10DLC Registration, OTP verification and limits · Checked 2026-10-14
44. 44
    Once a Telnyx messaging profile's daily spend limit is reached, new messages are rejected with error 40333.

    Messaging Profiles Overview · Messaging Profiles Overview, Spend Limits · Checked 2026-10-14
45. 45
    A Telnyx messaging profile can carry a daily outbound spend limit in USD, and the day resets at 00:00 UTC.

    Setting Up a Messaging Profile · Setting Up a Messaging Profile, Outbound Settings, Enable Daily Spend Limit Per Connection · Checked 2026-10-14
46. 46
    Telnyx pages describe the ready-to-assign campaign state with different labels (ACTIVE in the developer guides, MNO Approved in the help article, MNO_PROVISIONED in the webhooks reference), which probably name the same carrier-approved state.inferred

    10DLC Event Notification Webhooks · Event Notification Webhooks, campaign status values; compare Campaign Registration, campaign statuses and support article 6325734 prerequisites · Checked 2026-10-14
47. 47
    Per Telnyx, T-Mobile sets daily 10DLC SMS caps per brand rather than per campaign, by vetting score: 75-100 gives 200,000, 50-74 gives 40,000, 25-49 gives 10,000, 1-24 gives 2,000, and sole proprietor gives 1,000.

    10DLC Rate Limits · 10DLC Rate Limits, T-Mobile section, brand tier table · Checked 2026-10-14
48. 48
    Setting messaging_profile_id to null removes a Telnyx number from its messaging profile, after which the number no longer receives inbound message webhooks.

    Phone Number Messaging Configuration · Phone Number Messaging Configuration, unassign note · Checked 2026-10-14
49. 49
    Telnyx warns that US long codes without 10DLC registration, or not assigned to a campaign, face carrier filtering and possible blocking on AT&T, T-Mobile and other major US networks.

    Phone Number Messaging Configuration · Phone Number Messaging Configuration, Warnings · Checked 2026-10-14
50. 50
    Per Telnyx, unvetted 10DLC brands default to T-Mobile's Basic tier of 2,000 SMS per day unless the business is listed on the Russell 3000 index.

    10DLC Rate Limits · 10DLC Rate Limits, T-Mobile section, note below tier table · Checked 2026-10-14
51. 51
    A registered Telnyx 10DLC campaign's use case cannot be changed in place; changing it requires a new campaign.

    10DLC Campaign Registration · 10DLC Campaign Registration, use case types · Checked 2026-10-14
52. 52
    Per Telnyx, Verizon has not published specific 10DLC throughput numbers and relies on content-based filtering instead of explicit rate limits.

    10DLC Rate Limits · 10DLC Rate Limits, Verizon section · Checked 2026-10-14
53. 53
    Telnyx says 10DLC brand vetting typically takes 1-7 business days, and enhanced vetting may take longer.

    10DLC Getting Started · 10DLC Getting Started, timelines table, Vet brand row · Checked 2026-10-14
54. 54
    Telnyx's brand guide prices external vetting by class: BRAND_DEFAULT $4.50, STANDARD $41.50 and ENHANCED $101.50, and each vetting submission incurs a fee.

    10DLC Brand Registration · 10DLC Brand Registration, vetting cost by class · Checked 2026-10-14
55. 55
    Telnyx blocks a new external vetting with the same provider and class within 180 days of a successful one (error 10012); failed vettings do not count, so they can be retried at once.

    10DLC Brand Registration · 10DLC Brand Registration, resubmission / duplicate checks · Checked 2026-10-14
56. 56
    A Telnyx messaging profile accepts a webhook_failover_url that is used when the primary webhook URL is unreachable.

    Messaging Profiles Overview · Messaging Profiles Overview, Webhook configuration · Checked 2026-10-14
57. 57
    The Telnyx Create a messaging profile API treats webhook_url as optional, defaulting to an empty string; only name and whitelisted_destinations are required.disputed

    Create a messaging profile · Create a messaging profile, request body, webhook_url · Checked 2026-10-14
58. 58
    The Telnyx messaging profiles overview lists the profile webhook URL as a required setting with no default.disputed

    Messaging Profiles Overview · Messaging Profiles Overview, settings table, webhook_url row · Checked 2026-10-14
59. 59
    Each whitelisted_destinations entry on a Telnyx messaging profile is an ISO 3166-1 alpha-2 country code, and the value ["*"] allows every destination.

    Create a messaging profile · Create a messaging profile, request body, whitelisted_destinations · Checked 2026-10-14

Documents

Cite this page

WarmTransfer. (2026, October 14). Setting up Telnyx messaging profiles and 10DLC. WarmTransfer. https://warmtransfer.net/knowledge/telnyx-messaging-setup

@misc{warmtransfer-telnyx-messaging-setup,
  title  = {Setting up Telnyx messaging profiles and 10DLC},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/telnyx-messaging-setup},
  note   = {Verified 2026-10-14}
}