Connect Fit'Distance to your tools

Understand

7 short pages, to read once.

• Authentication

  How your key identifies every call: the Bearer header, one key per tool, revocation and the 401.

• Scopes

  What each scope opens: families and kinds, sensitive scopes, team, and the rule that ties Delete to Write.

• Pagination

  Read a list page by page with limit and cursor, reread only the changes with since, and handle deleted objects.

• Writes and idempotency

  Write with POST /operations, retry without duplicates using Idempotency-Key and preview an effect with dry_run.

• Webhooks

  Receive the events of your account on your server: create a webhook, verify the signature, answer fast, retries and GET /events to catch up.

• Errors

  The shape of an API error, the thirteen codes with their HTTP status and what they cost, and what to do with each.

• Limits

  The call limits per key, the 429 with Retry-After and the RateLimit headers, and how to resume without overloading.

Reference

Every route, generated from the API contract.

• General4 routes
• Students3 routes
• Training6 routes
• Check-ins2 routes
• Forms3 routes
• Messaging2 routes
• Nutrition3 routes
• Habits2 routes
• Appointments1 route
• Courses1 route
• Activity1 route
• Operations258 routes

Use cases

Complete automations to import into n8n.

• An email for each new student

  Every hour, read the students who joined since the last run and get one email per new student, with n8n or Make.

• Remind students without a check-in for 14 days

  Every Monday, send a short message to students who have sent no check-in for 14 days, with a first run that sends nothing.

• Remind inactive students

  Every Monday, send a short message to students with no finished workout for 14 days, with a first run that sends nothing.

• An online purchase → an invitation

  When a customer pays on Stripe, invite them to your coaching with Fit'Distance, after a first run as a preview, with n8n or Make.

• An Instagram DM → an activation code, with ManyChat

  When someone sends you a keyword in an Instagram direct message, ManyChat replies with an activation code created by Fit'Distance, with n8n or Make.

• A form submission → a note on the student's file

  Every answer to a Tally form becomes a private note on the student's file, with n8n or Make.

• The Monday recap, on Telegram or WhatsApp

  Every Monday at 8 am, get your week's recap on Telegram: new students, workouts, check-ins and habits, with n8n or Make.

• A program ends this week → an alert

  Every Monday, get on Telegram the list of the programs that end during the week, with n8n or Make.

• Student for 90 days → a review request

  Every Monday, ask for a Google review from the students who joined three months ago, after a first run that sends nothing, with n8n or Make.

• Follow a group of students automatically

  Tag a group of students, read their pending check-ins every morning, write the feedback and set the check-in to done.

For machines

The same information, readable by an AI or a client generator.

• The OpenAPI contract

  Where to read the OpenAPI contract of the API, how to generate a client with one command, and why the reference on this site says the same thing.

• llms.txt and llms-full.txt

  What the two text files for AIs contain, how to give them to an assistant and how to read each page as Markdown.

• The MCP server

  The address of the MCP server and the header to give it with your key, what the key opens, the five free tools and what costs a credit.

• openapi.json
• llms.txt
• llms-full.txt