Why you should use labels
When sending SMS, Voice messages or validating phone numbers (HLR / MNP), pass a label with the request. seven.io then groups your Analytics by label so you can see at a glance how many messages and how much spend each campaign, channel or team accounts for.
Typical use cases:
- separating different traffic types like two-factor authentication, appointment reminders or marketing campaigns
- tracking sending volume per branch, location or shipping point
- attributing messages to individual employees or to a specific feature in your app
A monthly report email also includes a breakdown of your top labels from the previous month.
How to use labels
Webapp
When sending directly from the webapp, expand the Label section in the Send Message dialog and enter your label.
HTTP API
Add the label parameter to your request, e.g. label=Campaign1. See the API documentation for details.
Mail API
When sending via the Mail API, pass the label parameter in the email subject, for example: from=Optician key=123456789 label=Campaign1. If you omit the label, the gateway uses the email sender as a fallback. See the Mail API documentation.
SMPP
If you are connected via SMPP, set the PDU element service_type to your label. Per SMPP v3.4, service_type is limited to 5 characters.