← All articles

Creating a Messaging Profile

A messaging profile is a configuration container for a group of numbers. Numbers attached to the same profile share opt-out behavior, allowed-destination rules, and sender defaults. Profiles save you from configuring each number individually and unlock smart routing across a pool.

Manage profiles at Messaging Profiles.

When to use multiple profiles

Most accounts only need one. Consider multiple when:

Creating a profile

  1. Open Messaging Profiles.
  2. Click New profile.
  3. Configure:
    • Name — internal label.
    • Allowed countries — defaults to US.
    • Opt-out keywords / message — defaults to STOP.
    • Opt-in keywords / message — defaults to START.
    • Help keywords / message — defaults to HELP.
  4. Save.

Assigning numbers

From the profile detail page (/messaging-profiles/<id>), click Assign numbers to pick the numbers you want associated. Numbers can belong to one profile at a time — assigning to a new profile moves them. Numbers must still be attached to a 10DLC campaign before sending US application traffic.

Sending from the profile

Every outbound POST /messaging/send request specifies a from number — the messaging profile groups your numbers and centralizes opt-out keyword handling and sender defaults, while the sending number itself is chosen by your application. Use the profile to keep opt-out behavior consistent across the numbers you send from.

Receiving inbound and status events

Inbound messages and delivery-status events are not delivered through the messaging profile. They're delivered through the account-wide webhook system: add an endpoint at Developer → Webhooks and subscribe to the events you need (message.received, message.sent, message.delivered, message.failed). Every event payload identifies the number it relates to, so a single endpoint can serve all of your numbers and profiles. See Configuring Webhooks for the event catalog and signature verification.

If the profile form shows a webhook URL field, it does not route your events — configure your endpoint in Developer → Webhooks instead.

Opt-out handling

When a recipient texts one of the configured opt-out keywords to a number in this profile, Blocx records the opt-out and replies with the configured opt-out message. Subsequent outbound messages from that number to the recipient are blocked until they opt in again with one of the configured opt-in keywords.

Editing or deleting

Edit a profile at any time. Changes apply immediately to in-flight and future messages.

Deleting a profile requires that no numbers are assigned. Reassign or release numbers first at Numbers → Manage.

Related articles