## Invite a member

`POST https://getkollek.com/api/account/members`

Invite someone to join the account at a given role. This creates an invitation and emails it. It does not create a member.

The invitation is claimed on the web, so the person becomes a member only once they follow the link and set up their user. Until then they show up under the invitations endpoint rather than the members one. The API cannot claim an invitation.

**Permissions:** Owners only. Editors and viewers get a 404 response.

### Body parameters

- `email` (string, required): The email address to invite, in lowercase. Maximum 255 characters.
- `role` (string, required): The role to grant. One of owner, editor or viewer.

**Returns:** The created invitation object.

### Example request

```bash
curl https://getkollek.com/api/account/members \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "phoebe@centralperk.test",
    "role": "editor"
}'
```

### Example response

`Status: 201`

```json
{
    "data": {
        "type": "invitation",
        "id": "1",
        "attributes": {
            "email": "phoebe@centralperk.test",
            "role": "editor",
            "expires_at": 1753142400,
            "accepted_at": null,
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/account/invitations"
        }
    }
}
```