---
title: "Send SGOS invitation"
method: POST
path: "/coaches/{id}/send-invitation"
tags: ["Coaches"]
---

# Send SGOS invitation

`POST /coaches/{id}/send-invitation`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/coaches/{id}/send-invitation`
- Auth: HTTP bearer

Send or resend an SGOS invitation email with a magic link to the coach

## Path parameters

- `id` string, uuid, required

## Response `200`

Invitation sent successfully

- object
  - `success` boolean
  - `data` object
    - `sent` boolean: Whether the invitation was sent
    - `isResend` boolean: Whether this was a resend of a previous invitation
    - `expiresAt` string, date-time: When the magic link expires
  - `message` string

## Other responses

- `400`: Coach does not have an email address
- `401`: Unauthorized
- `404`: Coach not found
- `429`: Rate limit exceeded (max 5 requests per email per hour)

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)