Creating a Messaging Profile

A messaging profile is a configuration container for a group of numbers. Numbers attached to the same profile share inbound webhook URLs, opt-out behavior, and routing 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:

Different product lines or brands need different inbound webhooks (e.g., support vs. marketing).
You want isolated reporting per profile.
You're delegating numbers to different teams or downstream customers.
You're a CPaaS reseller and want one profile per tenant.

Creating a profile

Open Messaging Profiles.
Click New profile.
Configure:
- Name — internal label.
- Webhook URL — where we POST inbound and status events for this profile.
- Webhook failover URL (optional) — secondary URL if the primary fails.
- 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.
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 inbound and status handling, while the sending number itself is chosen by your application. Use the profile to keep webhook routing and opt-out keyword handling consistent across the numbers you send from.

Webhooks

Configure your endpoint URL on the profile to receive inbound and status events for traffic on numbers in that profile. Subscribe to the events you need (message.sent, message.delivered, message.failed, message.received) and see Configuring Webhooks for signature verification details.

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.