Send your first customer event

Before you start

This quickstart uses AttuneMail's Segment-compatible server API. Keep the write key on a trusted server; do not place it in browser or mobile application code.

• ✓An AttuneMail workspace
• ✓A Segment-compatible server event connection
• ✓The one-time connection write key copied when the connection is created
• ✓A stable user ID from your application and, ideally, the customer's permissioned email address

1. Create a server event connection

1. 01

   Open Automations → Events

   Choose Connections, then create a Segment-compatible server source.

2. 02

   Name the source

   Use a stable name such as Production API or Staging API so event lineage remains obvious.

3. 03

   Copy the write key

   Store it in your server-side secret manager. The base URL is https://www.attunemail.com/v1.

2. Identify the customer and track an event

Send an identify message before or alongside the first track message. The identify call links a stable user ID to useful traits; the track call records what happened.

curl -u 'ame_replace_me:' \
  -H 'Content-Type: application/json' \
  -d '{"batch":[{"type":"identify","messageId":"identify_123","userId":"cus_123","traits":{"email":"customer@example.com","first_name":"Avery"}},{"type":"track","messageId":"event_123","userId":"cus_123","event":"trial.activated","properties":{"plan":"growth"}}]}' \
  'https://www.attunemail.com/v1/batch'

3. Verify before automating

1. 01

   Confirm the response

   A successful request reports success, a batchId, received count, and duplicate count.

2. 02

   Inspect the event ledger

   Open Events and confirm the customer, event name, source, properties, and processing status.

3. 03

   Send a test journey event

   Build a draft journey with trial.activated as its trigger, use the built-in test action, and inspect the resulting enrollment before activating the journey.