Make your first API request

API v3 — Current ≈ 10 minutes

Create your first container, then retrieve the URL used by the next step in your journey — the same flow every Livstick integration starts from.

Prerequisites

An access token provided by the Livstick team. If you don’t have one yet, request developer access.

Create a container

A container holds the video message and its delivery settings. The crid is your own business reference — an order number, a card code — and it is the only required field.

POST /containers

curl -X POST https://client-api.v5.livstick.com/api/v3/containers \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ "crid": "ORDER-123", "language": "en_us" }'

Retrieve the shareable URL

Call it with the same crid you chose in step 1.

GET /containers/{crid}/url

curl https://client-api.v5.livstick.com/api/v3/containers/{crid}/url \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Next steps

With a container and its URL, you can embed the Recorder widget in your own journey, or hand the URL to the delivery path you chose.