# Onboarding athletes and coaching groups

**URL:** <https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864>\
**Category:** Guide\
**Created:** [11 July 2025 11:36 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864 "2025-07-11T11:36:43Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![david](https://forum.intervals.icu/user_avatar/forum.intervals.icu/david/32/30189_2.png) [@david](https://forum.intervals.icu/u/david)\
**Post date:** [11 July 2025 11:36 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/1 "2025-07-11T11:36:43Z")

</div>

This guide describes how teams and coaching businesses can easily onboard, manage and communicate with their athletes.

Intervals.icu has groups (similar to WhatsApp) for easy communication and sharing of workouts and training plans:

 ![Screenshot 2025-07-11 at 10.48.08](https://forum.intervals.icu/uploads/default/original/3X/d/6/d6f91d522872c4ea6f3d11bd1297af833d962295.jpeg)

A group can be set as a coaching group. A coaching group automatically grants coach access to all users with “Member” role in or added to the group, to all group admins and coaches. Note that this is a premium feature, you need to be a supporter to create a coaching group.

 ![Screenshot 2025-07-11 at 13.10.15](https://forum.intervals.icu/uploads/default/original/3X/c/d/cd32fb8eb423274d08e51884e65aa6cf484a2ad3.png)

You can have multiple coaching groups each with different coaches. Group admins can add/remove users (athletes and coaches) and set roles within the group. Athletes and coaches can be in multiple groups. The “Follower” role grants read-only access to group members.

Groups can have branding which is applied to Intervals.icu for group members:

 ![Screenshot 2025-07-11 at 13.24.10](https://forum.intervals.icu/uploads/default/original/3X/b/9/b93e313fe609194cdc7efec3a12a403d6d7737b1.jpeg)

Members added to a coaching group or already in a group set as a coaching group are sent message from the admin asking them to accept:

 ![Screenshot 2025-07-11 at 13.32.11](https://forum.intervals.icu/uploads/default/original/3X/8/4/84f1645664f1abaafb35c899e3f78c2446d796fd.png)

If they answer “No” or do nothing they remain in the group but no additional access is granted.

If they answer yes then all the group admins and coaches are granted coach access. The member receives a chat message from each coach:

![Screenshot 2025-07-11 at 13.42.16](https://forum.intervals.icu/uploads/default/optimized/3X/6/8/683999f1614c71721b0c8ceec11d8d23e5d0f543_2_517x30.png)

### Onboarding process summary

- Create one or more coaching groups or make an existing group a coaching group
- Add coaches to groups and set their role to “Coach” (they must be supporters)
- Ask athletes to register on Intervals.icu and send them links to the groups (e.g. [https://intervals.icu/g/weekend-noodlers](https://intervals.icu/g/weekend-noodlers)) you want them to join. They just have to click one of the admins and ask to join
- Accept the join request messages
- Athletes will receive the “you have been added” message and need to accept to complete the process
- You can also use the “Add Athletes” button in group settings but that will not show athletes who have set their profile to be “Hidden”

Athletes added to a coaching group are automatically assigned coaches from the group once they accept the invitation to join the group. The coaching relationships are updated when coaches are added to or removed from the group or the athlete leaves.

**Edit: 21st Nov 2025** : You can now setup all the athletes you coach in a group at once: [Setup multiple athletes at once](https://forum.intervals.icu/t/setup-multiple-athletes-at-once/116054)

### Updating group settings

Click the dot dot dot menu on the right hand side of the group chat and choose “Settings”:

 ![Screenshot 2025-07-11 at 14.10.46](https://forum.intervals.icu/uploads/default/original/3X/b/7/b77e8cab2b02a9919dd921c1b22eb0d22b051989.png)

 ![Screenshot 2025-07-11 at 17.58.07](https://forum.intervals.icu/uploads/default/original/3X/5/8/582fe1bcd9548b4f9a41dd4db946e0ed543d1433.jpeg)

All members can use “Your Primary Group” to toggle the group branding on/off. Only admins can change the other settings.

Ticking the “Visible to non-members” box will make the group show up in search so people can find it and ask to join. “Hide membership” hides the group membership list for members, they can only see who the admins and coaches are.

Click member tiles to change roles, remove people etc..

Tick “Coaching Group” to upgrade the group. You should assign coach role to your coaches first.

### Future plans

- Soon it will be possible to purchase coins for the group with each coin granting supporter status (access to premium features like weather analysis) to a member for 1 month
- Filtering the /athletes tabs by group, along with the current tag filtering
- Pushing settings (zones, charts, activity summary layouts) and so on down to group members

---

<div class="post-metadata">

**Author:** ![Gerald](https://forum.intervals.icu/user_avatar/forum.intervals.icu/gerald/32/28423_2.png) [@Gerald](https://forum.intervals.icu/u/Gerald)\
**Post date:** [11 July 2025 14:48 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/2 "2025-07-11T14:48:11Z")

</div>

Thanks David,

The URL doesn’t save, and disappears when I return the group.

 ![image](https://forum.intervals.icu/uploads/default/original/3X/5/d/5d0695ae6cf3403822d315b0b2d2a132245a72ac.png)

The background I mentioned, in our previous chat, still shows as transparent on the side bar.

 ![WhatsApp Image 2025-07-11 at 16.46.43_5e0bebf7](https://forum.intervals.icu/uploads/default/original/3X/c/7/c723e36754a33f2a1a2980bd685d1e831863e0f8.jpeg)

---

<div class="post-metadata">

**Author:** ![david](https://forum.intervals.icu/user_avatar/forum.intervals.icu/david/32/30189_2.png) [@david](https://forum.intervals.icu/u/david)\
**Post date:** [11 July 2025 15:57 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/3 "2025-07-11T15:57:08Z")

</div>

Hmm. I could add a url to my test group. You do need to include the http:// or https:// prefix or an error pops up.

I have fixed the transparent sidebar issue. You do need to go and choose the colour again. The picker was returning transparent colours which is good for charts, not for the sidebar. I also changed the button text from “Group UI” to “Branding”. Tx.

---

<div class="post-metadata">

**Author:** ![Gerald](https://forum.intervals.icu/user_avatar/forum.intervals.icu/gerald/32/28423_2.png) [@Gerald](https://forum.intervals.icu/u/Gerald)\
**Post date:** [11 July 2025 16:28 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/4 "2025-07-11T16:28:27Z")

</div>

Sorted now, thanks.

---

<div class="post-metadata">

**Author:** ![Rory\_D\_Sutherland](https://forum.intervals.icu/user_avatar/forum.intervals.icu/rory_d_sutherland/32/61597_2.png) [@Rory\_D\_Sutherland](https://forum.intervals.icu/u/Rory_D_Sutherland)\
**Post date:** [1 August 2025 17:00 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/5 "2025-08-01T17:00:36Z")

</div>

Hey David, sorry if I missed this – I would love to have multiple coaching groups in Intervals, including my personal clients. However, I would like my personal client coaching group to be anonymous to everyone else in the group. Is this possible?

---

<div class="post-metadata">

**Author:** ![Gerald](https://forum.intervals.icu/user_avatar/forum.intervals.icu/gerald/32/28423_2.png) [@Gerald](https://forum.intervals.icu/u/Gerald)\
**Post date:** [1 August 2025 18:15 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/6 "2025-08-01T18:15:40Z")

</div>

> [@Rory\_D\_Sutherland](#):
>
> However, I would like my personal client coaching group to be anonymous to everyone else in the group. Is this possible?

Yes, it’s possible.

Go to chat (left menu)  
Select your group - if set up  
**(Right menu) Tick the box - Hide membership** ← this is what you’re looking for.  
(Right menu) Untick the box - Visible to non-members

Here’s my setup

 ![image](https://forum.intervals.icu/uploads/default/original/3X/3/5/35fef1ad3bafb2b2b5b37f6e53809896f7d16a7c.png)

Branding allows you to change colours and add your company/coaching logo.

This is what it looks like from an athlete level.  
I have a test account, to be able to see what my athlete would see.

 ![image](https://forum.intervals.icu/uploads/default/original/3X/7/d/7dedd544d0d81792115e431e20add272976bd5db.png)

---

<div class="post-metadata">

**Author:** ![david](https://forum.intervals.icu/user_avatar/forum.intervals.icu/david/32/30189_2.png) [@david](https://forum.intervals.icu/u/david)\
**Post date:** [1 August 2025 18:58 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/7 "2025-08-01T18:58:58Z")

</div>

As @Gerald says it is possible. Be aware though that if people write messages in the group chat their names will appear. If that is a problem we could add a “only admins and coaches can post in the chat” option for “broadcast” groups.

---

<div class="post-metadata">

**Author:** ![ilbonvi](https://forum.intervals.icu/user_avatar/forum.intervals.icu/ilbonvi/32/78007_2.png) [@ilbonvi](https://forum.intervals.icu/u/ilbonvi)\
**Post date:** [2 August 2025 07:51 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/8 "2025-08-02T07:51:03Z")

</div>

This feature could be useful

---

<div class="post-metadata">

**Author:** ![Justin\_Hunt](https://forum.intervals.icu/user_avatar/forum.intervals.icu/justin_hunt/32/28111_2.png) [@Justin\_Hunt](https://forum.intervals.icu/u/Justin_Hunt)\
**Post date:** [18 August 2025 12:10 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/9 "2025-08-18T12:10:30Z")

</div>

Hi David,

We attempted to set this up and have a quick question.  
For the athletes who join via the link, it doesn’t appear that we, as admins or coaches, are seeing their activities. I can go into the admin panel and then request to follow, but I didn’t think that was going to be necessary for the coaching group?

---

<div class="post-metadata">

**Author:** ![david](https://forum.intervals.icu/user_avatar/forum.intervals.icu/david/32/30189_2.png) [@david](https://forum.intervals.icu/u/david)\
**Post date:** [18 August 2025 17:25 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/10 "2025-08-18T17:25:01Z")

</div>

Oooh there were some problems with that case that we have just fixed. Will deploy Tuesday AM. Tx for the report.

We have also added. warning on coaching groups so people joining via the link know what they signing up for.

 ![Screenshot 2025-08-18 at 19.24.32](https://forum.intervals.icu/uploads/default/original/3X/6/0/6060226bfa8ce1b9ba2fc9532c6001e0e45bf8fe.png)

---

<div class="post-metadata">

**Author:** ![thruswicki](https://forum.intervals.icu/user_avatar/forum.intervals.icu/thruswicki/32/49543_2.png) [@thruswicki](https://forum.intervals.icu/u/thruswicki)\
**Post date:** [25 August 2025 20:14 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/11 "2025-08-25T20:14:10Z")

</div>

This would be very useful. Will it be possible to implement?

---

<div class="post-metadata">

**Author:** ![Rory\_D\_Sutherland](https://forum.intervals.icu/user_avatar/forum.intervals.icu/rory_d_sutherland/32/61597_2.png) [@Rory\_D\_Sutherland](https://forum.intervals.icu/u/Rory_D_Sutherland)\
**Post date:** [29 August 2025 16:37 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/12 "2025-08-29T16:37:44Z")

</div>

Thanks everyone, really appreciate the response here.

---

<div class="post-metadata">

**Author:** ![lorinczoliver](https://forum.intervals.icu/user_avatar/forum.intervals.icu/lorinczoliver/32/33080_2.png) [@lorinczoliver](https://forum.intervals.icu/u/lorinczoliver)\
**Post date:** [22 September 2025 11:22 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/13 "2025-09-22T11:22:06Z")

</div>

This feature would be great. Is it coming soon?

---

<div class="post-metadata">

**Author:** ![david](https://forum.intervals.icu/user_avatar/forum.intervals.icu/david/32/30189_2.png) [@david](https://forum.intervals.icu/u/david)\
**Post date:** [22 September 2025 18:53 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/14 "2025-09-22T18:53:46Z")

</div>

It is under development. Should be live in a day or so.

---

<div class="post-metadata">

**Author:** ![david](https://forum.intervals.icu/user_avatar/forum.intervals.icu/david/32/30189_2.png) [@david](https://forum.intervals.icu/u/david)\
**Post date:** [23 September 2025 06:37 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/15 "2025-09-23T06:37:46Z")

</div>

You can now prevent normal members from posting to the chat. Combine this with “Hide membership” to keep group membership secret:

 ![Screenshot 2025-09-23 at 08.35.32](https://forum.intervals.icu/uploads/default/original/3X/b/a/ba3416d151f99081df4b378649c073f243fc1d66.png)

---

<div class="post-metadata">

**Author:** ![david](https://forum.intervals.icu/user_avatar/forum.intervals.icu/david/32/30189_2.png) [@david](https://forum.intervals.icu/u/david)\
**Post date:** [21 November 2025 11:01 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/16 "2025-11-21T11:01:09Z")

</div>

We have added support for bulk setup of athletes:

> [@Setup multiple athletes at once](https://forum.intervals.icu/t/setup-multiple-athletes-at-once/116054):
>
> We have added a premium feature to configure multiple athletes in one go to the group and /athletes pages. Currently copying your own custom items (activity fields, interval fields, zones, charts, streams etc.) is supported. Other setup operations will be added in future. You can choose from your custom items, select from your coached athletes and update them all. If the athlete a…

---

<div class="post-metadata">

**Author:** ![Gerald](https://forum.intervals.icu/user_avatar/forum.intervals.icu/gerald/32/28423_2.png) [@Gerald](https://forum.intervals.icu/u/Gerald)\
**Post date:** [7 June 2026 12:59 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/17 "2026-06-07T12:59:13Z")

</div>

Hi @david  
I looked, and couldn’t find, in the API docs for a list of athletes that I coach.  
I was hoping to find a list with the status that shows one/more of the options:

- “coaching” only is ticked
- "coaching"and “prospect” are ticked
- “prospect” only is ticked  
There is the third tick box for “pros”, which I don’t have pros on my list.

Is this available?  
Also, is a “date joined” available? This is the date the user created their account.

---

<div class="post-metadata">

**Author:** ![Gabriel\_Vargas](https://forum.intervals.icu/user_avatar/forum.intervals.icu/gabriel_vargas/32/36904_2.png) [@Gabriel\_Vargas](https://forum.intervals.icu/u/Gabriel_Vargas)\
**Post date:** [7 June 2026 13:31 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/18 "2026-06-07T13:31:17Z")

</div>

I was looking for the same thing and found that the endpoint

[https://intervals.icu/api/v1/athlete/0/athlete-summary.json](https://intervals.icu/api/v1/athlete/0/athlete-summary.json)

returns a summary of all coached athletes associated with your coach account, including athlete IDs and names. That was enough for me to build a list of athletes and then query additional athlete-specific endpoints.

However, from what I could see, this endpoint does not appear to expose the coach-side flags such as “coaching”, “prospect” or “pro”, nor does it include account creation or join dates. The returned data is mostly activity and performance summary information (athlete\_id, athlete\_name, fitness, fatigue, activity counts, etc.).

---

<div class="post-metadata">

**Author:** ![Gerald](https://forum.intervals.icu/user_avatar/forum.intervals.icu/gerald/32/28423_2.png) [@Gerald](https://forum.intervals.icu/u/Gerald)\
**Post date:** [7 June 2026 13:34 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/19 "2026-06-07T13:34:50Z")

</div>

> [@Gabriel\_Vargas](#):
>
> [https://intervals.icu/api/v1/athlete/0/athlete-summary.json](https://intervals.icu/api/v1/athlete/0/athlete-summary.json)

Thanks for that; certainly helps with one or two checks I need.  
I’m looking at some workflows that I want only implemented for “active” athletes. Hoping the “coaching only” tick allows me to filter out those without the tick.

edit: I’m also looking to keep the editing in Intervals only. So as I change the coaching status, everything else updates accordingly.

---

<div class="post-metadata">

**Author:** ![david](https://forum.intervals.icu/user_avatar/forum.intervals.icu/david/32/30189_2.png) [@david](https://forum.intervals.icu/u/david)\
**Post date:** [8 June 2026 09:48 UTC](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864/20 "2026-06-08T09:48:13Z")

</div>

We have added `GET /api/v1/athletes`

List athletes the caller is following or coaching, including the caller. This endpoint cannot be called with a bearer token, an API\_KEY is required.

[Next page](https://forum.intervals.icu/t/onboarding-athletes-and-coaching-groups/108864.md?page=2)
