Data dictionary: SMS events – Ometria Help Centre

You can create a regular, scheduled data export from Ometria to an AWS S3 bucket, Databricks, Google Cloud, Microsoft Azure, or an SFTP you host.

See also: Customised data export

SMS events data relates to your automation and broadcast SMS sends. The exported data includes all SMS events, e.g. sends, deliveries, clicks etc.

Note: Empty fields are passed as `null` - this means Ometria has no data for that field.

If you'd like to set up a data export please get in touch with your Customer Success Representative.

Field	Type	Description
event_id	String	The unique identifier for the event. `"event_id": "18cc38e9-3f49-40e6-8396-8f705d82a988"`
uuid	String	The universally unique identifier for the message sent. `"uuid": "43ce2130-985a-4d1f-9edb-dd7b5cfc45db"`
event_type	String	The type of SMS event recorded. One of: sent, delivered, delivery_failed, clicked, unsubscribed. `"event_type": "sent"`
dt_occurred	Time	The date and time the event occurred. `"dt_occurred": "2026-05-04T08:00:28.220000"`
customer_id	String	The contact's Customer ID. Use this to join SMS events to your contact records. `"customer_id": "crm010461547"`
profile_hash	String	A unique, encoded identifier for the contact's profile, sometimes called a profile ID. `"profile_hash": "2a3d-d71d41-012e263e"`
campaign_title	String	The title of the campaign this message is part of. `"campaign_title": "A_SMS_CONCIERGE_BIRTHDAY_1"`
campaign_type	String	The type of phone number the message was sent from, e.g. TF (toll-free), 10DLC, alphanumeric, or short code. `"campaign_type": "TF"`
node_id	String	The unique ID of the send SMS action node in an automation campaign. This is only populated for automation campaigns. `"node_id": "zni4m7pd"`
node_label	String	The name you have given the send SMS action in an automation campaign. This is only populated for automation campaigns. `"node_label": "VIP welcome"`
channel_type	String	The messaging channel. This is always sms for SMS events. `"channel_type": "sms"`
direction	String	Whether the message was sent to the contact or received from them. `"direction": "outgoing"`
retailer_number	String	The sender ID or number the message was sent from. `"retailer_number": "Ometria"`
contact_number	String	The contact's phone number the message was sent to. `"contact_number": "123456789100"`
country	String	The country the contact's phone number is registered to. `"country": "GB"`
chargeable_units	Integer	The number of message segments the send was charged as. Longer messages are split into more than one segment. `"chargeable_units": 1`
send_classification	String	Whether the message was sent as a marketing or transactional message. `"send_classification": "marketing_message"`
coupon_code	String	The coupon code included in the message, if any. `"coupon_code": "vip-7vlwt4gvxc"`
utm_params	String (JSON object)	The campaign tracking parameters on the links in the message, as a JSON object. `"utm_params": {"utm_campaign": "a_sms_vip_welcome", "utm_medium": "sms", "utm_source": "automation"}`
reason	String	The reason a message failed, where applicable. This is null unless the event_type is delivery_failed. `"reason": "Unknown subscriber"`
OMETRIA_EXPORTED_AT	Time	The date and time the record was included in your export. `"OMETRIA_EXPORTED_AT": "2026-05-07T13:49:08.335783+00:00"`

Related articles