Becoming a partner
Get your platform approved, register the IP addresses your servers call from, and receive the partner secret that authenticates you for every customer.
Partner access is granted by Vitruve, once per platform. Until then your platform does not appear in your customers' Settings → Integrations, and no customer can create a key for you.
What to send
Write to support@vitruve.fit with:
| Item | Why |
|---|---|
| Your platform's name, as customers know it | It is shown to customers next to the Create button in Settings → Integrations → Export. |
| A technical contact | Vitruve contacts them about rotations, address changes and incidents. |
| Your egress IP addresses | Every request is checked against them. See below. |
| What your integration does with the data | So Vitruve can confirm the partner endpoints cover it. |
Register your egress addresses
Vitruve compares the address each request arrives from against the list registered for your platform.
- Send the public addresses your servers send requests from, not the ones that receive traffic. Single IPv4 or IPv6 addresses and CIDR ranges up to
/24(IPv4) or/48(IPv6) are accepted. Wider ranges are refused. - Include every environment that calls Vitruve with real customer keys: production workers, schedulers, staging.
- If your servers do not have fixed outbound addresses, set up a NAT gateway or a static egress IP first.
- Tell Vitruve before your addresses change, for example when you move cloud region or replace a NAT gateway. Vitruve updates the list without changing your secret.
Requests from any other address, including a proxy or VPN you did not register, answer 403 Request origin not allowed for this integration.
Receive your partner secret
Vitruve sends you a partner secret, once. It starts with vtp_. Vitruve only keeps a hash of it and cannot show it to you again, so store it right away in a secrets manager.
One secret, every customer
The same secret authenticates you for all of your customers. Keep it on your servers only, never in a browser, mobile app, log line or support ticket.
To replace it later without downtime, see Rotate your secret.
Next
Make your first request: Partner quickstart.
Partner integrations
For S&C platforms that connect to Vitruve on behalf of shared customers: read each customer's people, workouts and measurements with their key and your partner secret.
Partner quickstart
From your partner secret to your first customer's athletes and workouts, with both credentials.