Invite Member

Invite a new team member to your organization. They'll receive an email with a link to set their password.

team.invite

POST/v1/team

Request Body

Parameter	Type	Description
name*	string	Member's full name
email*	string	Email address (must be unique)
role*	string	Role: admin, editor, or viewer
permissions	string[]	Custom permissions array (overrides role preset)
sendInvite	boolean	Send welcome email with password setup link (default: true)

Example Request

curl

curl -X POST "https://proforms.io/api/v1/team" \
  -H "Authorization: Bearer pf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sarah Chen",
    "email": "sarah@example.com",
    "role": "editor",
    "permissions": ["forms.view", "forms.edit", "submissions.view", "submissions.export"]
  }'

Response

200 OK

{
  "success": true,
  "data": {
    "id": "u_new123",
    "name": "Sarah Chen",
    "email": "sarah@example.com",
    "role": "editor",
    "permissions": [
      "forms.view",
      "forms.edit",
      "submissions.view",
      "submissions.export"
    ],
    "createdAt": "2026-02-17T11:00:00.000Z"
  }
}

💡

Roles are just presets that auto-fill permissions. You can customize individual permissions for any user regardless of their role. See Authentication for the full permissions list.