Set the creator’s timezone
Sets the creator's timezone — the same setting their dashboard uses for day bucketing.
/api/external/timezoneSets the creator's timezone — the same setting their dashboard uses for day bucketing.
The value must be a valid IANA name (anything in Intl.supportedValuesOf('timeZone')). This changes what the creator sees on their own Dropfans dashboard too, not just your API reads — only call it when the creator asked for it.
Authentication
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
Request body
Content type: application/json
| Name | Type | Required | Description |
|---|---|---|---|
timezone | string | Required | IANA timezone name, e.g. "Europe/Stockholm". Abbreviations like "CET" are not accepted. Format: iana-timezone |
{
"timezone": "Europe/Stockholm"
}Responses
| Name | Type | Description |
|---|---|---|
timezone | string | IANA timezone name (e.g. "Europe/Stockholm"). Defaults to "UTC" when the creator never set one. Format: iana-timezone |
{
"timezone": "Europe/Stockholm"
}Errors
| Status | Body | When |
|---|---|---|
| 400 | {"error":"Invalid timezone"} | Missing, non-string, or not a recognised IANA timezone name. |
| 400 | {"error":"Invalid JSON body"} | The request body is not valid JSON. |
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
Rate limiting
Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.
Code samples
curl -X PUT "https://www.dropfans.io/api/external/timezone" \
-H "Authorization: Bearer $DROPFANS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"timezone": "Europe/Stockholm"
}'const res = await fetch(`https://www.dropfans.io/api/external/timezone`, {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"timezone": "Europe/Stockholm"
}),
});
console.log(await res.json());import os
import requests
res = requests.put(
"https://www.dropfans.io/api/external/timezone",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
json={
"timezone": "Europe/Stockholm",
},
)
print(res.json())Questions? [email protected]