Team Management

Manage your team settings, members, and invitations.

Get team details

GET /v1/team

Returns your team's information and settings.

Required permission: team:read

curl https://api.texting.blue/v1/team \
  -H "x-api-key: tb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

{
  "id": "team_xxxxxxxxxxxx",
  "name": "Acme Corp",
  "plan": "pro",
  "monthly_message_limit": 10000,
  "created_at": "2026-01-01T10:00:00Z"
}

---

Update team settings

PUT /v1/team

Update your team's name.

Required permission: team:write

curl -X PUT https://api.texting.blue/v1/team \
  -H "Content-Type: application/json" \
  -H "x-api-key: tb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"name": "Acme Corporation"}'

---

List team members

GET /v1/team/members

Returns all members of your team.

Required permission: team:read

curl https://api.texting.blue/v1/team/members \
  -H "x-api-key: tb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

{
  "members": [
    {
      "id": "usr_xxxxxxxxxxxx",
      "email": "[email protected]",
      "name": "John Doe",
      "role": "owner",
      "created_at": "2026-01-01T10:00:00Z"
    },
    {
      "id": "usr_yyyyyyyyyyyy",
      "email": "[email protected]",
      "name": "Jane Smith",
      "role": "member",
      "created_at": "2026-01-15T14:00:00Z"
    }
  ]
}

---

Invite a team member

POST /v1/team/members/invite

Send an invitation to join your team.

Required permission: team:write

Request body

Field	Type	Required	Description
email	string	Yes	Email address of the person to invite
role	string	Yes	Role to assign: admin, member, or viewer

Example

curl -X POST https://api.texting.blue/v1/team/members/invite \
  -H "Content-Type: application/json" \
  -H "x-api-key: tb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"email": "[email protected]", "role": "member"}'

Response

Status: 201 Created

{
  "invitation_id": "inv_xxxxxxxxxxxx",
  "email": "[email protected]",
  "role": "member",
  "expires_at": "2026-02-14T12:00:00Z"
}

Invitations expire after 7 days. The invitee receives an email with a link to accept.

---

Change member role

PUT /v1/team/members/:id/role

Change a team member's role.

Required permission: team:write

curl -X PUT https://api.texting.blue/v1/team/members/usr_yyyyyyyyyyyy/role \
  -H "Content-Type: application/json" \
  -H "x-api-key: tb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"role": "admin"}'

---

Remove a team member

DELETE /v1/team/members/:id

Remove a member from your team. Owners cannot be removed.

Required permission: team:write

curl -X DELETE https://api.texting.blue/v1/team/members/usr_yyyyyyyyyyyy \
  -H "x-api-key: tb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

---

Roles and permissions

Role	Dashboard	Send messages	Manage numbers	Manage team	Manage billing
Owner	Full access	Yes	Yes	Yes	Yes
Admin	Full access	Yes	Yes	Yes	No
Member	Full access	Yes	No	No	No
Viewer	Read-only	No	No	No	No

Plan limits

The number of team members allowed depends on your plan:

Plan	Team members
Free	1
Starter	3
Pro	10
Enterprise	Unlimited

Next steps

• Error codes -- Complete error reference
• Team management in the dashboard -- GUI guide