Generate UUID

Generate UUID is an API that creates unique identifiers (UUID v4) to use as a record ID, an idempotency key, or anything that needs an identifier that never repeats.

How it works

You ask for however many UUIDs you need and get them back generated on the spot, using Node.js's own cryptographic generator: none are stored or reused.

All you need

Your API key. Create it in your dashboard with "+ Create key". It's shown only once, so copy and save it.
In your automation platform, an "HTTP Request" step (n8n, Make, Zapier, Pipedream… all have one).

How to use it in n8n (step by step)

In the HTTP Request node:

Method: POST
URL: https://api.cofferdock.com/generate-uuid
Send Headers: on → add two: x-api-key = your key, and Content-Type = application/json
Send Body: on → Body Content Type: JSON → {} (for 1 UUID) or { "count": 5 } (for several)

In Make (HTTP → Make a request module): same method and URL, Body type: Raw, Content type: JSON, with the same body.

Options (inside the JSON)

Option	Default	What it does
`count`	`1`	How many UUIDs to generate at once (up to 100).

API overview

Endpoint: POST https://api.cofferdock.com/generate-uuid
Auth: header x-api-key: YOUR_KEY.
Input: application/json, optional body (can be empty).
Engine: Node.js's native crypto.randomUUID() (UUID v4, cryptographic generator).
Limits: 30 requests/min per IP. 1 call = 1 credit, no matter how many UUIDs you ask for.

Options

Option	Default	Description
`count`	`1`	Integer between 1 and 100 (400 otherwise).

Examples

curl:

curl -X POST "https://api.cofferdock.com/generate-uuid" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":5}'

JavaScript (Node 18+):

const r = await fetch('https://api.cofferdock.com/generate-uuid', {
  method: 'POST',
  headers: { 'x-api-key': 'YOUR_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ count: 5 }),
});
const { uuids } = await r.json();

Python:

import requests
r = requests.post(
    'https://api.cofferdock.com/generate-uuid',
    headers={'x-api-key': 'YOUR_KEY', 'Content-Type': 'application/json'},
    json={'count': 5},
)
print(r.json())

Response

{ "success": true, "uuids": ["a1b2c3d4-e5f6-4789-a123-456789abcdef", "..."],
    "meta": { "count": 5, "used": 12, "remaining": 488 } }

What you get back

Always an array in uuids, even if you only ask for 1, so there's just one response shape to handle.