Create a reminder from your own system
Use an HTTP request from your server or an automation tool's HTTP step. This recipe uses the YouGot REST API; it doesn't require a native connector.
Before you start
- An account with current Business access, including an active Business evaluation.
- An API key from API Keys. Keep the key on your server and out of public client code.
- A future scheduled time. Replace the example timestamp with your desired time in ISO 8601 with an explicit offset.
Start with your own email
curl -X POST https://www.yougot.ai/api/v1/reminders \
-H "Authorization: Bearer $YOUGOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message":"Review the client handoff","scheduledAt":"2030-01-10T15:00:00Z","channel":"email","metadata":{"sourceRecordId":"handoff-123"}}'A successful response is HTTP 201 with an id and the reminder document. Store that ID with your source record. Check the reminder in your dashboard, and confirm the actual email delivery at its scheduled time.
Add a participating teammate
Invite them in Group settings and wait for acceptance. Use their user ID in recipientIds. Open Team and choose Copy ID next to the accepted teammate. Use a designated test teammate first.
"recipientIds": ["ACTIVE_GROUP_MEMBER_USER_ID"]Non-self recipients must be active members of the caller's group. A forbidden or removed recipient is rejected; membership does not expose their personal reminders or grant them a paid plan.
Handle failures and duplicates
- 401: missing, invalid or revoked Bearer key. 403: Business access is unavailable. 429: slow down according to the rate-limit headers.
- 400: validate the scheduled time, channel, recipient membership and plan limits.
- No inbound idempotency key is currently supported. The source record in metadata is a label, not automatic duplicate protection. Store the returned ID in your source system; after a timeout, inspect the dashboard or list your reminders before deciding whether to retry.
- Email, SMS and WhatsApp delivery consume their channel allowances. Start with email; phone channels need verified phone numbers and consent.
Clean up
Cancel or archive the test reminder in the dashboard. Revoke the test API key when finished. Trial switching keeps the original expiry; API access stops when Business entitlement ends.