If you are wiring ClockItDown into a script or an internal tool, you can skip the form. Send a POST /create request, keep the redirect URL, and use that countdown link wherever you need it.

This endpoint does not return JSON. It creates the event, then redirects you to the countdown page:

/countdown/<event_id>

That redirect target is the URL you want to keep.

Send the API request

Send a JSON body with these fields:

• title: event name, trimmed and limited to 50 characters
• targetDate: future date and time in ISO 8601 format
• timezone: IANA timezone such as Europe/Paris or UTC

Example:

curl -X POST https://clockitdown.com/create \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Product launch",
    "targetDate": "2026-12-01T18:30:00",
    "timezone": "Europe/Paris"
  }'

If the payload is valid and the date is still in the future, the server creates the event and redirects to its page. If a required field is missing or the date is invalid, the server sends you back to the home page instead.

Get the event page URL from the redirect header

The quickest way is to read the Location header in the response.

curl -i -X POST https://clockitdown.com/create \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Product launch",
    "targetDate": "2026-12-01T18:30:00",
    "timezone": "Europe/Paris"
  }'

In the response headers you should see something like this:

HTTP/1.1 302 FOUND
Location: /countdown/7f3a9c1d

That relative path is the new event page. If you need the full URL, add your site base URL in front:

https://clockitdown.com/countdown/7f3a9c1d

Get the final URL with curl

If you prefer to follow the redirect and print the final URL directly, use -L with curl’s url_effective output:

curl -s -L -o /dev/null -w '%{url_effective}\n' \
  -X POST https://clockitdown.com/create \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Product launch",
    "targetDate": "2026-12-01T18:30:00",
    "timezone": "Europe/Paris"
  }'

Example output:

https://clockitdown.com/countdown/7f3a9c1d

This is usually the easiest option when you want to create a countdown and capture its page URL in a script.

Example in a shell script

Here is a small shell example that stores the generated page URL in a variable:

event_url=$(curl -s -L -o /dev/null -w '%{url_effective}' \
  -X POST https://clockitdown.com/create \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Team offsite",
    "targetDate": "2026-11-20T09:00:00",
    "timezone": "UTC"
  }')

printf '%s\n' "$event_url"

One detail to keep in mind

The event ID comes from the server. You do not send it yourself. After creation, the server builds the final page URL with this pattern:

/countdown/<event_id>

If your integration needs the event page, the redirect is the source of truth.