Send Tabular emails to your own app.

Post every export to your own app: the HTML, the plain text and the email’s details, as JSON.

How Tabular works with Webhook

The webhook sends every export to a URL you choose, so your own app can store the email or send it through your own mail service.

Connect Webhook

Point the webhook at a URL in your app. Add a username and password, and Tabular signs in with HTTP basic auth.

  1. Set up an endpoint in your app

    An HTTPS URL that accepts a JSON POST.

  2. Open an email and click Export

    Choose Send via integration, then pick Webhook under All integrations.

  3. Fill in the form and upload

    Name it, paste the endpoint URL, and add a username and password if you use basic auth. Then click Upload.

  4. It’s saved for your workspace

    Next time, pick it under Your authentications.

Connect WebhookExport › Send via integration
Authorization nameOur appEndpoint URLhttps://api.yourapp.com/hooks/tabularBasic auth usernameOptionalBasic auth passwordOptional Upload

Credentials are stored encrypted and belong to the workspace, not to one person. Remove them any time in workspace settings, under Integrations.

What Tabular sends

A POST with a JSON body, on every export. Add a username and password, and Tabular signs in with HTTP basic auth.

POST https://api.yourapp.com/hooks/tabular
Content-Type: application/json

{
  "email": {
    "id": "8f2c41d0",
    "name": "Spring launch",
    "folder": {
      "name": "Campaigns",
      "team": { "name": "Lumen" }
    }
  },
  "metadata": {
    "subjectLine": "Spring, in full bloom.",
    "preheader": "Five new colours, free shipping this week.",
    …
  },
  "html": "<!doctype html><html lang=\"en\">…</html>",
  "plainText": "Spring, in full bloom.\n\nHand-blown glass lamps…",
  "languageTag": "en"
}
email
Which email this is, and the names of its folder and workspace. Use the ID to match a new export to what you stored before.
metadata
The email’s settings from the editor, like the subject line and preheader.
html · plainText
The finished email, ready to send, and its plain-text version.
languageTag
The language version this export is for. Each language posts on its own.

Update an email

There’s nothing to overwrite: each export posts the email again, with the same email.id. Match on that ID and the language, and replace what you stored.

  1. Change the email in Tabular

    Text, images, layout, or a change to your design system.

  2. Export to your webhook again

    Pick it under Your authentications.

  3. Replace your copy

    Match on email.id and languageTag.

Spring launchDMExport
Lumen

Spring collection

Spring, in full bloom.

Shop the collection
Export “Spring launch”EN
2 of 3 exports this month
Send via integrationCopyZIP filePDF file
New connection
Search integrations… Your authenticationsOur appWebhook All integrations
Send to Our app
New templatePOST to api.yourapp.com Upload
Uploaded to WebhookYour template is now in Webhook, ready to send.Make another export
Send via integrationEN
Update a connectionOur appEN#4821Our appDE#4822 Create new connection
api.yourapp.com
WebhookRequests
Lumen

Spring collection

Spring, in full bloom.

Shop the collection
Spring launchPOST · 200 · 2 days ago
Lumen

Lumen

Welcome to Lumen.

Open
Welcome, part 1 · enPOST · 200 · 5 days ago

Questions

What does the webhook send?
A JSON POST on every export: the email’s ID, name, folder and workspace, its subject line and preheader, the HTML, the plain text and the language.
Can I secure the endpoint?
Yes. Add a username and password, and Tabular signs every request with HTTP basic auth. The URL must use HTTPS.