Skip to main content

Poll

A poll for booking appointments

descriptionstringnullablerequired

Poll description

durationintegerrequired

Poll duration in minutes

idstringrequired

Unique poll identifier (opaque ID)

namestringrequired

Poll name

publicize_responsesbooleanrequired

Publicize responses?

scope object

Associated scope/team

idstringrequired

Scope ID

namestringrequired

Scope name

slugstringrequired

Scope slug

slots object[]required

Slots for this poll

  • Array [
  • end_atdate-timerequired

    Slot end time

    rankintegerrequired

    Rank of this slot

    start_atdate-timerequired

    Slot start time

    votesintegerrequired

    Number of votes for this slot

  • ]
  • slugstringrequired

    URL slug for the poll

    statestringrequired

    Poll state

    Possible values: [draft, published, complete, deleted]

    urlstringrequired

    Poll URL

    Poll
    {
    "description": "Let's find a time to meet!",
    "duration": 30,
    "id": "poll_abc123",
    "name": "Meeting with John",
    "publicize_responses": true,
    "scope": {
    "id": "scope_xyz789",
    "name": "Sales Team",
    "slug": "sales"
    },
    "slots": [
    {
    "end_at": "2024-01-20T14:30:00Z",
    "rank": 1,
    "start_at": "2024-01-20T14:00:00Z",
    "votes": 1
    }
    ],
    "slug": "meet",
    "state": "published",
    "url": "https://savvycal.com/p/john/meet"
    }