Skip to main content
PUT
/
api
/
v1
/
sync-settings
Update Sync Settings
curl --request PUT \
  --url https://www.catchthegoodones.com/api/v1/sync-settings
{
  "tier": "pro",
  "timezone": "America/New_York",
  "syncTimes": ["09:00", "17:00"],
  "nextSyncAt": "2026-04-17T17:00:00.000Z"
}
Updates your timezone and/or the sync schedule for a specific tier. At least one of timezone or syncTimes must be provided. When updating syncTimes, the tier field is required.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here
Content-TypeYesapplication/json

​
Body

FieldTypeRequiredDescription
tierstringConditional"starter", "growth", or "pro". Required when updating syncTimes.
timezonestringNoIANA timezone identifier (e.g. "America/New_York")
syncTimesarray of stringsNoSync times in HH:MM format. Times must be on the quarter hour (:00, :15, :30, :45).

​
Example

# Update timezone only
curl -X PUT https://www.catchthegoodones.com/api/v1/sync-settings \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"timezone": "Europe/London"}'

# Update sync times for the pro tier
curl -X PUT https://www.catchthegoodones.com/api/v1/sync-settings \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"tier": "pro", "syncTimes": ["09:00", "15:00", "21:00"]}'

# Update both timezone and sync times
curl -X PUT https://www.catchthegoodones.com/api/v1/sync-settings \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"tier": "pro", "timezone": "America/New_York", "syncTimes": ["09:00", "17:00"]}'

​
Response

{
  "tier": "pro",
  "timezone": "America/New_York",
  "syncTimes": ["09:00", "17:00"],
  "nextSyncAt": "2026-04-17T17:00:00.000Z"
}

​
Notes

  • The maximum number of sync times depends on the tier. Pro supports up to 4, while starter and growth have lower limits.
  • Sync times use a 24-hour format and must land on quarter-hour boundaries.
  • Changing your timezone also adjusts the daily sync counter reset time.