API Documentation

Build integrations with the GifyLabs REST API. All endpoints use JSON and require HTTPS.

Quick Start

Use the POST /timers endpoint with your target date and template.

Copy the image URL from the response and add it to your email HTML.

Authentication Header

Authorization: Bearer YOUR_TOKEN

Free

10 req/s

Starter

25 req/s

Pro

50 req/s

Business

100 req/s

After creating a timer, embed it in your emails using a simple image tag:

<img src="https://cdn.gifylabs.com/render/YOUR_TIMER_ID"
     alt="Countdown Timer"
     width="600"
     style="max-width: 100%; height: auto;" />

The timer image is dynamically generated as a GIF and updates on each email open.

Status	Meaning	Description
400	Bad Request	Invalid request body or parameters
401	Unauthorized	Missing or invalid JWT token
403	Forbidden	Insufficient permissions for this action
404	Not Found	Resource does not exist
409	Conflict	Resource already exists (e.g., duplicate email)
429	Too Many Requests	Rate limit exceeded
500	Server Error	Internal server error

Contact our support team for API assistance or integration guidance.

Set up real-time event notifications with webhooks. Works with Zapier.