FAfanvue

Invite a team member

Changed on

Invite a new team member to the authenticated user's agency by email.

The invitee must already have a Fanvue account. This endpoint invites an existing account onto an agency seat; it does not create an account and does not send a signup email. Invite an address with no account and the request is refused with manager-invite-creator.team-member-account-not-found — ask the person to sign up at fanvue.com first, then invite the address they signed up with.

A malformed address is rejected by request validation (HTTP 400, { "errors": [...] }). Every other rejection returns HTTP 400 with a stable code in error:

errorPrecondition that failed
USER_NOT_ALLOWEDThe address is banned, or it belongs to a creator account (creators join an agency through a creator invite, not a team seat), or the caller holds no team-management permission in the agency the invite would go into.
manager-invite-creator.invitation-already-sentThe address already holds a seat or a pending invite in this agency.
manager-invite-creator.team-member-already-agency-managerThe address already manages another agency, and has to leave it first.
manager-invite-creator.team-member-account-not-foundNo Fanvue account exists for the address.

<Info>Requires: Agency admin access</Info>

post/agencies/invites

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/agencies/invites
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: write:agency

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

emailstring email required

Email address of the user to invite

Response

Team member invited successfully

successboolean required
messagestring required
inviteUuidstring uuid required

Changes