🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Zoho Bigin Premium Add-on Setup Guide

Updated 5 min read Gravity Forms CRM & Email Marketing
On this page
  1. Step 1: Install and Activate Your License
  2. Step 2: Create a Zoho API Client
  3. Step 3: Connect with Bigin
  4. Step 4: Create a Feed
  5. Companies and Existing Contacts
  6. Pipeline Records (Deals)
  7. Custom Fields and Types
  8. Entry Notes, Resend and Failures
  9. Troubleshooting & FAQ
  10. Zoho shows “Invalid Redirect Uri”.
  11. The connection works but the lists are empty.
  12. Bigin says the stage is invalid.
  13. Can one form create different deals?

The Gravity Forms Zoho Bigin Premium Add-on sends every form submission to Bigin by Zoho CRM. It creates or updates the contact by email, links the company, adds a note with every answer, and can open a pipeline record (deal) in the right sub-pipeline and stage — with owner, tags and custom fields. The connection uses Zoho OAuth, so no Zoho password is stored on your site.

This guide covers installation, creating the Zoho API client, connecting, the contact and pipeline settings, custom fields, failures and troubleshooting.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher
  • PHP: Version 7.4 or higher
  • Gravity Forms: Version 2.9 or higher, any licence
  • Bigin: A Bigin plan with API access, and a Bigin user who may create contacts, companies and pipeline records
  • GravityExtra license: The add-on installed, activated and licensed with an active GravityExtra license key

Step 1: Install and Activate Your License

  1. In WordPress go to Plugins → Add New → Upload Plugin, upload the add-on ZIP file and click Activate.
  2. Go to Forms → Settings → Zoho Bigin. The Gravity Extra License section is at the top.
  3. Paste your license key from your GravityExtra account (My Account → License keys) and click Activate License. The Bigin connection settings appear below.

Step 2: Create a Zoho API Client

  1. In Forms → Settings → Zoho Bigin, choose your Zoho data centre: the domain you see when you sign in to Bigin (zoho.com, zoho.eu, zoho.in, zoho.com.au, zoho.jp, zohocloud.ca, zoho.sa or zoho.com.cn).
  2. Copy the Authorized Redirect URI shown on the page.
  3. Open the Zoho API Console for your data centre (for example api-console.zoho.com), click Add Client and choose Server-based Applications.
  4. Enter a client name (for example “Website forms”), your website address as the homepage URL, and paste the redirect URI. Click Create.
  5. Copy the Client ID and Client Secret into the add-on settings and click Save Settings. The secret is never shown again; the page only shows its last four characters.

Step 3: Connect with Bigin

Click Connect with Bigin. Zoho asks you to sign in and to allow access to your Bigin modules, settings and user list. After you accept, you return to WordPress and the page shows “Connected to Bigin as” your name. The add-on keeps a refresh token (never shown) and renews the short-lived access token automatically.

Zoho Bigin settings page in Gravity Forms with the GravityExtra license section, the Zoho data centre, the redirect URI to copy, the Client ID, a saved Client Secret shown only by its last four characters, a Connected to Bigin as Olivia Park status with Test connection and Disconnect buttons, and a backup email
Connected with Zoho OAuth: test or disconnect at any time.
  • Test connection checks the connection and reloads the owners, pipelines and fields.
  • Disconnect revokes the token at Zoho and removes it from your site.
  • Changing the Client ID or Client Secret disconnects the add-on; click Connect with Bigin again.

Step 4: Create a Feed

  1. Open the form, go to Settings → Zoho Bigin and click Add New.
  2. Map the Contact fields: email (required), first and last name, phone, mobile, job title, company name, company website, address and description.
  3. Map Custom contact fields: your Bigin custom fields are listed with their API names; read-only fields such as formulas are left out.
  4. Pick the Owner and add Tags such as website, {form_title}.
  5. Keep Add a note with every answer on so the full submission is on the contact, and save the feed.
Zoho Bigin feed contact section: email, names, phone, job title, company, website, address and description mapped to form fields, custom contact fields Team Size, Newsletter and Renewal Date, owner Sam Lee, tags, update or keep existing contacts and the note option
Contact, company, custom fields, owner and tags.

Companies and Existing Contacts

When a company name is mapped, the company is found by its name (or created, with the website) and linked to the contact. Contacts are matched by email: with Update the contact the new values are saved; with Keep the contact as it is a known contact is left unchanged and only the note and the pipeline record are added. Nobody is added twice.

Pipeline Records (Deals)

Tick Create a pipeline record to open a deal with each submission:

  • Deal name with merge tags, for example Quote: {Company:4}.
  • Team pipeline, Sub-pipeline and Stage: chosen from the lists read from Bigin, or typed exactly as they appear in Bigin.
  • Amount: a number or a merge tag such as {Budget:9}.
  • Closing date: a number of days after the submission.
  • The record is linked to the contact and the company, gets the same owner and tags, and can fill custom pipeline fields.
Zoho Bigin feed pipeline record section: deal name with the company merge tag, team pipeline Sales, sub-pipeline Sales Pipeline Standard, stage Needs Analysis, amount from the Budget field, closing in 14 days and a custom pipeline field
A deal in the Sales team pipeline, Needs Analysis stage.

Custom Fields and Types

Values are sent in the type of the Bigin field: checkboxes become true or false, numbers lose currency signs and separators, dates are sent as YYYY-MM-DD and multi-select picklists receive a list. Picklist values must match a Bigin choice exactly. For a fixed value, choose Add Custom Value on the right and type the text or a merge tag.

Entry Notes, Resend and Failures

  • Each entry gets a note such as “Bigin: new contact … created. Pipeline record … created.” and the Zoho Bigin box on the entry page shows the record IDs.
  • If Bigin refuses a record, the note shows its message and the field, for example “required field not found (Last_Name)”. A refused pipeline record does not undo the contact.
  • If the connection was revoked in Zoho, the note asks you to connect again. Failed submissions are emailed to the backup address, and Send to Bigin again retries the entry.
  • With Gravity Forms logging on, only record IDs and HTTP status codes are logged — never names, email addresses, tokens or the client secret.

Troubleshooting & FAQ

Zoho shows “Invalid Redirect Uri”.

The redirect URI in the Zoho API Console must match the one on the settings page exactly, including https and the ?action= part.

The connection works but the lists are empty.

Check that you chose the right data centre and click Test connection. The lists are kept for an hour.

Bigin says the stage is invalid.

The stage must belong to the chosen sub-pipeline. Pick both from the lists, or copy the names exactly from Bigin.

Can one form create different deals?

Yes. Add several feeds with conditional logic, each with its own sub-pipeline, stage and owner.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr