A walkthrough on setting up an email channel and using it
By following these instructions, you'll be able to setup an Email channel and use it to send messages through the API.
Step 1: Setup your API Key
In order to send messages through the API, you'll need an API key. Click the bottom left menu and then select User Settings.
User Settings menu
Head to Security -> Access Keys -> Add new access key.
Access key management
Create an access key with the role Application Developer.
Creating a new access key
Now you have an access key you'll be able to use when sending messages through the API.
Step 2: Create an email channel
In the top left menu, select Manage Channels -> Email.
Channels management
Click Install Email and fill out the information about your email channel.
Email channel installation
After creating your channel, you'll be presented with a few DNS records that need to be registered with your DNS provider. Once the DNS records are in place, click Verify domain at the bottom. You may need to retry this a few times due to DNS propagation times. If you're having difficulty with this step, check out the Troubleshooting section.
Email DNS records
If everything worked, in the Health tab you should see a message saying your channel is healthy and ready to be used.
Health tab
Lastly, take note of your channel ID in the settings tab, you'll need it when performing the API request.
Channel ID
Step 3: Check your workspace ID
The last thing we need to send messages is to know your workspace ID. In the bottom left menu, select User Settings and navigate to Organization -> Workspaces and then select your workspace, now you should be able to take note of your workspace ID.
Workspace ID
Step 4: Send a message
Use the command below to perform a request that sends a message. You'll need to fill in your workspace ID, your channel ID, your API key, and your email.
Step 5: Checking messages
You can verify the message status in the following ways:
1. UI
In the developer console, you can access Email -> Emails Log.
Email logs
Alternatively, you can navigate to your channel and switch to the Logs tab.
Channel logs
2. API
To retrieve message details through the API, refer to the Messaging API Documentation. You can find more information on the available endpoints, request formats, and required parameters.
3. Webhook
In the Developer console, head to Preferences -> Webhooks and create a webhook subscription to the channels service with the event email.outbound. For additional information, refer to the Notifications API.
Creating webhook
Troubleshooting
Unable to verify DNS records
If your DNS records can't be verified, use the dig tool to check that domains are responding with the expected value, for example:
Keep in mind it may take a few minutes for new DNS values to be propagated.
Another possibility is that your tracking domain is in use by another organization. To check if that's the case, make sure the health check for "Tracking Domain Exists" is OK.
