ZAPIER API DOCUMENTATION

Base URL

All endpoints are relative to the base URLhttps://blueskyapps.org

Authentication

All endpoints require authentication using the following headers:

x-id

The URL-encoded user ID

x-access-key

The Zapier access key associated with the user

Endpoints

1. Authenticate Zapier Connection

Endpoint: /auth_zapier

Method: GET

Description: Authenticates a Zapier connection and returns user information for the connection label.

Headers

x-id

URL-encoded user ID

x-access-key

Zapier access key

Response

{
  "success": true,
  "id": "user_id",
  "email": "user_email",
  "name": "user_full_name"
}

Error Response

{
  "error": "Invalid id"
}

or

{
  "error": "Invalid access key"
}

2. Subscribe to Zapier Webhook

Endpoint: /zapier_subscribe

Method: POST

Description: Subscribes a user to Zapier webhooks by storing the webhook URL.

Headers

x-id

URL-encoded user ID

x-access-key

Zapier access key

Request Body

{
  "hookUrl": "https://hooks.zapier.com/hooks/catch/..."
}

Response

{
  "success": true
}

Error Response

{
  "error": "Invalid user"
}

or

{
  "error": "Invalid access key"
}

or

{
  "error": "Could not update user hook url"
}

3. Unsubscribe from Zapier Webhook

Endpoint: /zapier_unsubscribe

Method: POST

Description: Unsubscribes a user from Zapier webhooks.

Response

{
  "success": true
}

4. List Meeting Data

Endpoint: /zapier_perform_list

Method: GET

Description: Returns sample meeting data with attendee information, designed to work with Zapier's Google Sheets integration.

Response

[
  {
    "meeting_id": "1",
    "meeting_url": "https://zoom.us/j/1234567890",
    "timestamp": "2025-03-21T12:00:00Z",
    "attendees": [
      {
        "displayName": "Test Attendee 1",
        "email": "[email protected]",
        "userId": "1234",
        "zoomID": "1234",
        "time_in_meeting": 20,
        "first_joined": "12:00 PM",
        "last_exited": "12:20 PM"
      },
      {
        "displayName": "Test Attendee 2",
        "email": "[email protected]",
        "userId": "2345",
        "zoomID": "2345",
        "time_in_meeting": 30,
        "first_joined": "12:01 PM",
        "last_exited": "12:31 PM"
      }
    ]
  }
]

Notes

Authentication is required for all endpoints using the x-id and x-access-key headers.