Skip to content
Waypoint documentation
Changelog

Changelog

Email message metadata

A small but mighty improvement for dev teams – metadata is now supported on Waypoint email messages. This allows teams to attach additional context for internal use and reference.

For example, when sending an email API via the API, you might want to include extra context. In the snippet below, we’re passing in a customerId, companyId, and transactionId:

POST v1/email_messages
Terminal window
curl "https://live.waypointapi.com/v1/email_messages" \
  -H "Content-Type: application/json" \
  -u "API_KEY_USERNAME:API_KEY_PASSWORD"  \
  -d '{
    "to": "jordan@usewaypoint.com",
    "templateId": "wptemplate_tuVKkNrLgZfM6KyQ",
    "variables": {
      "displayName": "Jordan"
    },
    "metadata": {
      "customerId": "customer_10928q3093840aap",
      "companyId": "company_sdafljaw09330r36",
      "transactionId": "transaction_a20394a339aa390a"
    }
  }'

This metadata isn’t just available when fetching individual emails API — it’s also included visible on message detail pages in your dashboard.

Updated docs

Additionally, message metadata is also accessible from webhook payloads. Example:

{
  "createdAt": "2025-04-21T14:03:01.357Z",
  "emailMessage": {
    ...
    "metadata": {
      "customerId": "customer_10928q3093840aap",
      "companyId": "company_sdafljaw09330r36",
      "transactionId": "transaction_a20394a339aa390a"
    }
  },
  "emailMessageId": "em_wUpG2hHHvfncz8EY",
  "id": "log_vJayu2MEA7ZZXTuQ",
  "message": "Email successfully delivered to jordan@usewaypoint.com. Delivery time: 0.2 seconds.",
  "updatedAt": "2025-04-21T14:03:01.357Z"
}

Activity search

Perform searches within your activity page to quickly find messages created within your workspace.

To search:

  1. Navigate to your ‘Activity’ page within your workspace.
  2. Click on the magnifying glass icon.
  3. Add a search term.
  4. Hit Enter.

Learn more in our docs

API endpoint: List emails

Use our new email messages API endpoint to pull a report of your email messages, with optional date filters. Get the full picture, including delivery events like bounces, clicks, and complaints.

GET v1/email_messages
Terminal window
curl "https://live.waypointapi.com/v1/email_messages?createdAt.gt=2024-02-11T17:53:00Z" \
-H "Content-Type: application/json" \
-u "API_KEY_USERNAME:API_KEY_PASSWORD"

Updated docs

Our docs have been refreshed with updated guides, improved navigation, and a smarter search.

Updated docs

API endpoint: batch message report

With our new batch email messages API endpoint, you can now get a report with all of the email messages that were sent through an email batch. See the full context for each of your emails in your batch including delivery events like bounces, clicks, and complaints.

GET v1/batches/:id/email_messages
Terminal window
curl "https://live.waypointapi.com/v1/batches/batch_RmETGV42naFpgHjr/email_messages" \
-H "Content-Type: application/json" \
-u "API_KEY_USERNAME:API_KEY_PASSWORD"

Email Tracking Settings

By default, Waypoint tracks events for clicks and opens. This allows teams to gather insights around activity within individual emails.

To track opens, Waypoint places a 1x1 pixel transaprent image within each message to track every time someone opens an email. To track clicks, Waypoint modifies (and masks) all links in a message to use a proxy URL to record the click before redirecting to the destination.

Due to these tradeoffs, teams may decide to turn these tracking settings off. These options can now be configured directly within your workspace settings page.

Tracking Screenshot on Waypoint

Webhooks

One of our most requested features is now available – webhooks. Webhooks are how services notify each other of events. On Waypoint, customers can use webhooks take action after an email event like a ‘bounce’ or ‘delivery’ has happened.

For example, posting a notification in a Slack channel whenever an email bounces or is marked as spam.

Add custom webhook endpoint URLs or use our Slack and Zapier integrations to make it even easier to connect and transform your data as needed.

Add and configure Waypoint endpoint

Improved user management and roles

Workspaces now include improved user management and roles to support additional team flexibility. This includes:

  • A new workspace ‘Owner’ role.
  • Owners can reassign ownership to another admin.
  • Owners and Admins can now remove users and open invites.

As always, teams on Waypoint can add an unlimited amount of admins and users to their workspace for no additional cost.

Waypoint team members screenshot

API endpoint: email message timeline events

Our new email message events API endpoint gives teams the ability to access the full timeline of events on an individual email message. These events include when the message was created, every open, click, bounce, or any other event found in our email event message logs.

This is especially helpful for teams that want to show this timeline of events to their own customers. For example, a CRM software platform may want to show these delivery events to help their customers better understand deliverability.

GET /v1/email_messages/EMAIL_MESSAGE_ID/events

Message timeline

Dynamic Colors on Templates

Waypoint’s new dynamic colors feature allow teams to theme email templates based on data. This is especially useful for vertical SaaS platforms (eg. software for yoga studios) that want to apply their customer’s branding and colors on email templates instead of their own. View an example/tutorial.

At the heart of Waypoint’s template builder is the use of data variables to apply the dynamic elements of a template. While these variables are most often used for dynamic text and images, they can now be used to set dynamic colors on a template or layout.

Dynamic color variables

From a template or layout builder, simply click on the {} icon next to a color within the global ‘Styles’ tab to set a theme color override based on data. Example: {{company.brandColor}}.

Usage report

Track usage (and any overages) easier on Waypoint.

All of our subscription tiers come with a base set of emails included on each plan. For example, our starter plan includes 10,000 live emails sends. To help teams better track usage, we’ve added a simple report within the billing section on your workspace settings page.

Additionally, any overages are now automatically calculated and billed as part of your monthly invoice.

Usage report screenshot

Note: If you are currently on a paid workspace and not seeing this, you should see it at the start of your next invoice cycle.

API endpoint: previewing templates

Teams can now preview a Waypoint email template via API. This is especially helpful for teams that want to show a preview of an email (within their platform) before sending through Waypoint. For example, an invoicing platform.

Use the new endpoint and optionally pass in custom data or with your template’s test data to get the processed HTML template as a response.

POST /v1/templates/TEMPLATE_ID/preview

Learn more in our API reference for template previewing.

Liquid currency filters

Display money values in your templates without the headaches. Teams can now convert numbers to formatted and localized currency strings with our new ‘currency’ Liquid templating filter.

Liquid currency filter

Waypoint template builder using the new Liquid currency filter to format the variable output of 10.5 to $10.50 (defaults to USD).

Learn more about using Liquid templating on Waypoint.

EmailBuilder.js – open source email template builder

We’ve released a free and open source community version of our much-loved email template builder.

We call it EmailBuilder.js – a powerful block-based email builder that takes the best parts of other open source libraries like Editor.js and email component libraries and puts them into an easy to use no-code builder that dev teams can extend and self-host.

Learn more:

Improved block error handling

Typos or simple syntax issues can easily happen when working with dynamic data on email templates. This can be frustrating if you’re unable quickly diagnose the problem. This is why we’ve added new error messages at the block level to help you get back on track quickly.

Unsubscribe groups

Waypoint now supports unsubscribes. Teams can now use ‘unsubscribe groups’ to append an unsubscribe link to a related set of emails.

If a contact clicks the unsubscribe link, they will be opted-out and will not receive any additional emails with the matching unsubscribe group.

Since Waypoint manages the unsubscribes and the unsubscribe page, teams can give their users the option to unsubscribe from a set of emails with a single line of code.

Download 'raw' LiquidJS templates

‘Raw’ templates are now available from a new Waypoint API endpoint.

This means teams can now build email templates visually on Waypoint and then use our new API endpoint to programmatically grab the template with ready-to-process templating system (LiquidJS) with variables, loops, conditionals, and more.

This is especially useful for teams sending sensitive data (eg. HIPAA compliance) and want to store email templates within their codebase.

Learn more in our blog post

More sample templates + gallery

Starting with a blank template is always a challenge. This is why we’ve added 20+ more ready-to-edit templates on Waypoint. These templates cover a wide range of product-triggered emails that are commonly used across marketplaces, SaaS, and e-commerce applications. Use them to either get started faster or simply to serve as inspiration for your own templates.

Simply choose from one of our new samples while creating a new template on Waypoint:

Create a new template modal screenshot

Not using Waypoint yet? View these templates on our new templates gallery page. You can even download a free HTML export of the template for your own use!

Templates gallery screenshot

Batch API sends

Sending a weekly report or recommendations email? Waypoint now supports batch email sending on our API so you can send multiple emails with highly personalized content with a single API call. Learn more in our docs.

Terminal window
curl "https://live.waypointapi.com/v1/sandbox/batches" \
  -H "Content-Type: application/json" \
  -u "API_KEY_USERNAME:API_KEY_PASSWORD"  \
  -d '{
    "emailMessages": [
      {
        "templateId": "wptemplate_RXL7zGTGsvkXzAP3",
        "to": "Jordan Isip <jordan@usewaypoint.com>",
        "variables": {
          "username": "fixie"
        }
      },
      {
        "templateId": "wptemplate_RXL7zGTGsvkXzAP3",
        "to": "Carlos Rodriguez <jordan@usewaypoint.com>",
        "variables": {
          "username": "cohitre"
        }
      }
    ]
  }'