Integration overview

// A sketch: apiKey, projectId, externalId, data and the db helpers are yours.
// Your API base URL is given to you during onboarding.
const TALLYMOTION_API = process.env.TALLYMOTION_API_URL;

// Store the key before the first send, so a retry after a lost response reuses it.
const key = await db.idempotencyKeyFor(externalId); // e.g. crypto.randomUUID(), saved once

const res = await fetch(`${TALLYMOTION_API}/v1/renders`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
    "Idempotency-Key": key,
  },
  body: JSON.stringify({ projectId, externalId, data }),
});

if (res.status !== 202) throw new Error(`Render not accepted: ${res.status}`);
const render = await res.json();
await db.saveRenderId(externalId, render.id);

// A sketch: a route on your own server, not ours. Register its URL with us at onboarding.
// verify() checks the Standard Webhooks signature; share() is your own channel.
app.post("/webhooks/video-ready", (req, res) => {
  const event = verify(req);
  if (event.type === "render.ready") {
    // Share the video through your own channel
    share(event.data.externalId, event.data.videoPageUrl);
  }
  res.sendStatus(200);
});