How to get notified with webhooks?
A webhook is an automatic notification: each time a client does something (sends you a chat message, finishes a workout, comments on an exercise…), TrainerStudio calls a web address (a URL) that you give it. Your AI agent, your Zapier or Make automation, or your own system finds out right away, without asking every few minutes.
You do not need to know how to code: the tool you want to connect gives you a URL and you paste it into TrainerStudio. The technical details are in the developer documentation.
1. Open the Webhooks tab
Go to Your app → Developers in the sidebar (also under Settings → Developers) and open the Webhooks tab.
Only the account owner can manage webhooks.
2. Add an endpoint
An endpoint is the URL that receives the notifications.
- Click Add endpoint.
- In Endpoint URL, paste the address your tool gave you. It must start with
https://. - In Description, write something that helps you recognize it: "Zapier, new messages", "AI agent".
- Choose what you want to receive:
- All events: you get everything, including event types we add later.
- Only the events I choose: you select the ones you care about.
- Save.
You can have up to 10 endpoints. Create one per tool: if you stop using a tool, you delete only its endpoint.
Available events
| Event | Sent when |
|---|---|
| Chat message received | A client sends you a message in the app chat |
| Workout completed | A client finishes the workout of the day |
| Comment on a workout | A client leaves a comment, photo or video on an exercise |
| Metric recorded | A value is recorded for one of a client's metrics |
| Task completed | A client completes a task |
| Progress photo uploaded | A client uploads a progress photo |
| Form answered | A client answers a form |
The notification says what happened and to which client, but it does not include the content (no message text, no measurements). Your tool reads the details with its own access to your account.
3. Copy the signing secret
When you create the endpoint, the Copy your signing secret window appears. The secret (it starts with whsec_) lets your tool check that the notification really comes from TrainerStudio.
- It is shown only this once. Copy it and paste it into your tool before clicking I've copied it.
- If your tool does not ask for a secret (many simple automations do not), you can go on without using it.
- If you lose it, rotate the secret to get a new one.
4. Send a test event
On the endpoint's page, click Send test event. Within a few seconds you see how your tool answered:
- Delivered: everything works.
- Failed: you see why (the URL does not answer, it takes more than 10 seconds, it returns an error…). Check the URL in your tool and try again.
5. Review deliveries
Each endpoint's page shows:
- Statistics for the last 7 or 30 days: success rate, response time and deliveries per day.
- Delivery log: every notification sent in the last 30 days. Open one to see its attempts, your tool's answer and the exact content that was sent.
- Send again: re-sends a notification that failed, for example after you fix your tool.
If a delivery fails, TrainerStudio retries it by itself up to 8 times over a little more than a day, waiting longer each time. You do not have to do anything.
6. Rotate the secret if you lose it
On the endpoint's page, click Rotate secret. You get a new secret and, for 24 hours, notifications are signed with both the new and the previous one: you have that long to change it in your tool without losing notifications.
7. Turn off or delete an endpoint
- Turn off stops sending notifications to that endpoint and cancels the ones still waiting. You can Turn on again at any time. Events that happen while it is off are not sent later.
- Delete endpoint removes it for good. You cannot undo it.
If TrainerStudio turns it off by itself
An endpoint is turned off automatically when:
- it has not accepted any delivery for 3 days, or
- your tool answers that the address no longer exists.
You see a notice with the reason on the endpoint's page. Fix the problem in your tool and click Turn on again.
Good to know
- Treat the URL and the secret like a password. Do not share or publish them.
- One endpoint per tool, with a clear description.
- The same notification can arrive twice when there was a retry. Robust tools account for it; keep it in mind if you use a simple automation.
- Notifications can arrive out of order. Each one carries the time it happened.
- Just want to talk to your data from ChatGPT or Claude? You do not need webhooks: follow the dedicated guides.