Repull
Docs/API Reference/Guests

Guests

Guest profiles with contact information.
GET/v1/guests

List guests with search

Query Parameters

limitintegerDefault: 50

Max results

searchstring

Search by name

Request

curl https://api.repull.dev/v1/guests \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID"

Response

{ "data": [{ "id": "789", "firstName": "Sarah", ... }], "pagination": { ... } }
GET/v1/guests/:id

Get a guest profile by ID

Request

curl https://api.repull.dev/v1/guests/123 \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID"

Response

{
  "data": {
    "id": "789",
    "firstName": "Sarah",
    "lastName": "Mitchell",
    "language": "en",
    "contacts": [
      { "type": "EMAIL", "value": "sarah@example.com", "isPrimary": true },
      { "type": "PHONE", "value": "+15551234567", "isPrimary": false }
    ],
    "createdAt": "2026-01-10T08:00:00Z"
  }
}
POST/v1/guests

Create a new guest

Body Parameters

firstNamestringRequired

Guest first name

lastNamestring

Guest last name

languagestring

Language preference (default: en)

Request

curl -X POST https://api.repull.dev/v1/guests \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "firstName": "value",
  "lastName": "value",
  "language": "value"
}'

Response

{ "data": { "id": "790", "firstName": "Marco", ... } }
Previous← List GuestsNextCreate Guest →
AI