Idempotent requests

Idempotency lets you safely retry a request without accidentally triggering the same operation twice. On certain API endpoints API, pass an optional metaId (eg. my_product_123). If a connection error happens mid-request, you can repeat it without worrying about a duplicate send.

cURL

curl "https://live.waypointapi.com/v1/email_messages" \
  -H "Content-Type: application/json" \
  -u "API_KEY_USERNAME:API_KEY_PASSWORD"  \
  -d '{
  "templateId": "wptemplate_ABc123XYZ",
  "metaId": "my_product_123",
  "to": "jordan@usewaypoint.com",
  "variables": {
    "user": {
      "displayName": "Jordan"
    },
    "product": {
      "title": "Beechers Mac & Cheese",
      "id": "02934203942"
    }
  }
}'

Node.js

const authHeader =
  'Basic ' + Buffer.from(`${API_KEY_USERNAME}:${API_KEY_PASSWORD}`).toString('base64');

const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: authHeader,
  },
  body: JSON.stringify({
    templateId: 'wptemplate_ABc123XYZ',
    metaId: 'my_product_123',
    to: 'jordan@usewaypoint.com',
    variables: {
      user: {
        displayName: 'Jordan',
      },
      product: {
        title: 'Beechers Mac & Cheese',
        id: '02934203942',
      },
    },
  }),
};

fetch('https://live.waypointapi.com/v1/email_messages', options)
  .then((res) => res.json())
  .then((res) => console.log(res))
  .catch((err) => console.error(err));