Gravity Forms + Calendly Integration Premium Add-on Documentation

The Gravity Forms Calendly Integration Premium Addon automates meeting scheduling workflows between WordPress and Calendly. By leveraging Calendly’s official REST API via a secure OAuth 2.0 handshake, this add-on dynamically generates new meeting Event Types—complete with custom durations, video conference locations (Google Meet, Zoom), and mapped invitee questions—upon every form submission, returning a direct scheduling link stored permanently in your entry notes.

---

1. Overview & Architectural Mechanism

Coordinating meetings through manual back-and-forth emails introduces severe latency into lead qualification and customer onboarding. The Gravity Forms Calendly Integration solves this by linking your front-end customer intake forms directly to Calendly’s event generation engine.

Here is how the automated scheduling workflow operates:

1. Lead Inquiry: A prospective client or partner submits an appointment inquiry, consultation request, or demo booking form on your WordPress site.
2. Data Normalization: Gravity Forms validates attendee inputs, meeting topic, desired duration (e.g. 15, 30, or 60 minutes), and meeting platform preference.
3. OAuth 2.0 API Handshake: The add-on dispatches an authenticated POST request to Calendly’s REST API endpoint (https://api.calendly.com/event_types) using an active Bearer access token.
4. Event Type Provisioning: Calendly creates the designated event type and generates a unique, shareable scheduling URL.
5. Entry Note Confirmation: The newly minted scheduling link is permanently recorded in the WordPress Gravity Forms Entry Notes for immediate administrative access and automated email notifications.

---

2. Prerequisites & Calendly Developer App Registration

To establish a secure API connection between Gravity Forms and Calendly, ensure your environment meets the following requirements:

• WordPress: Version 5.8 or higher.
• PHP: Version 7.4 or higher (PHP 8.0, 8.1, and 8.2 fully compatible).
• Gravity Forms: Core plugin version 2.8 or higher active.
• Calendly Account: An active Calendly account (Standard, Teams, or Enterprise recommended for multiple active event types).
• SSL / HTTPS: Calendly’s OAuth 2.0 specification strictly requires an HTTPS redirect URI.

Step 1: Registering Your OAuth 2.0 Application

Calendly requires all external integrations to authenticate via an OAuth App registered in your Calendly portal:

1. Log in to your Calendly account.
2. Navigate to the Calendly Developer Portal or Integrations → API & Webhooks.
3. Click Create New App (or register an OAuth application).
4. Enter an App Name (e.g., Gravity Forms Meeting Scheduler).
5. Set the Redirect URL to match the exact callback URL displayed in your WordPress settings:
   
   https://yourdomain.com/wp-admin/admin.php?page=gf_settings&subview=gf-calendly

Step 2: Retrieving API Credentials

Once registered, Calendly will display your unique credentials:

• Client ID: Your public OAuth identifier.
• Client Secret: Your private cryptographic secret key.

---

3. Step-by-Step Installation & Setup

Installing the add-on follows standard WordPress plugin deployment:

1. Download the gravityextra-calendly-addon.zip package from your GravityExtra My Account dashboard.
2. In WordPress Admin, go to Plugins → Add New → Upload Plugin.
3. Select the ZIP archive, click Install Now, and then Activate Plugin.
4. Navigate to Forms → Settings → Calendly to enter your license key for automated updates.

---

4. Global OAuth 2.0 Authorization & Token Lifecycle

Connecting Gravity Forms to Calendly requires a one-time OAuth handshake:

1. Go to Forms → Settings → Calendly in your WordPress dashboard.
2. Paste your Client ID and Client Secret into the respective input fields.
3. Click Save Settings.
4. Click the blue Connect button to initiate OAuth authorization.
5. A Calendly authorization window will appear—log in and click Accept / Authorize to grant permissions.
6. Upon successful redirection, a green confirmation badge will verify that your site is actively authenticated with Calendly.

---

5. Form Configuration & Feed Mapping

With authentication established, you can now link any Gravity Form to Calendly by configuring an integration feed.

Step 1: Create a New Calendly Feed

1. Navigate to Forms → Forms and click into your consultation or scheduling form.
2. Hover over Settings at the top of the form editor and click Calendly.
3. Click Add New to generate a feed.

Step 2: Map Feed Parameters & Custom Questions

In the feed editor, configure how submitted data constructs the Calendly meeting:

• Feed Name: Enter an identifiable title (e.g., 30-Min Strategy Consultation Feed).
• Event Name: Map to a form field or enter a dynamic name combining customer details (e.g. Strategy Call – {First Name} {Last Name}).
• Description / Agenda: Map to your form’s message or requirements field.
• Meeting Duration: Map to a dropdown field (e.g. 15, 30, 45, or 60 minutes) or set a static value.
• Meeting Location: Choose the preferred meeting venue from supported providers:
  • Google Meet: Automatically generates a Google Meet video conference link.
  • Zoom: Automatically provisions a Zoom meeting link via Calendly’s Zoom integration.
  • Microsoft Teams / Webex: Integrates with corporate conferencing tools.
  • Phone Call / In Person: Uses respondent phone or physical office address.
• Custom Questions Mapping: Map intake questions (such as “What would you like to discuss?”, “Number of employees”, or “Company Size”) to feed custom questions attached to the event.

---

6. Conditional Logic & Departmental Routing

Organizations often require different meeting parameters based on client persona or inquiry scope. Use Gravity Forms conditional logic to route entries dynamically:

• By Service Tier: Create a 60-minute in-depth feed for Enterprise inquiries, and a 15-minute quick discovery feed for Starter leads.
• By Platform Preference: Conditionally route applicants selecting “Zoom” to a Zoom-enabled feed, and those selecting “Google Meet” to a Meet-enabled feed.
• By Department: Direct sales consultations to account executive calendars and technical onboarding requests to engineering calendars.

---

7. Verification, Error Handling & FAQ

Confirming Successful Submissions

1. Submit a test booking inquiry through your front-end Gravity Form.
2. Go to Forms → Entries in your WordPress dashboard and open the submitted entry.
3. Review the Entry Notes on the right-hand panel. You should see a note confirming:
   
   Event created: <a href="https://calendly.com/your-username/meeting-slug">...</a>
4. Click the link to verify that the newly generated event type reflects all mapped details accurately.

Troubleshooting Common Error Codes

Error Code	Root Cause	Recommended Action
401 Unauthorized	Expired or revoked OAuth access token.	Navigate to Forms → Settings → Calendly and click Disconnect, then Re-connect to refresh tokens.
403 Forbidden (Quota)	Free Calendly plan event type limitation exceeded.	Free Calendly tiers permit only 1 active event type. Upgrade your Calendly plan to Standard or Teams to create multiple event types.
Redirect URI Mismatch	URL in Calendly Developer Portal does not match WordPress URL.	Ensure protocol (https), domain, and query parameters match the redirect URI exactly.

Frequently Asked Questions