​
Overview

You can use Gumloop to send contact data directly into Reevo using our Account & Contact Creation API. This guide walks you through how to generate an API key, construct a valid JSON payload (including custom fields if needed), and send it to Reevo via a Call API node in Gumloop. This integration is helpful for automating contact intake from forms, spreadsheets, or external systems.

​
Basic Concepts & Terminology

  • API Key – A secure token generated in Reevo that authorizes external tools like Gumloop to send data to your Reevo instance.
  • Webhook Endpoint – A URL where external systems send structured data (payloads) to Reevo.
  • JSON Payload – The format used to send contact data. It includes contact fields such as email, name, and optional custom field values.
  • Gumloop – A no-code workflow automation tool that connects data sources like Sheets or forms and allows sending structured data to APIs.
  • Call API Node – A Gumloop feature that sends HTTP requests to external services like Reevo.
  • Custom Fields – User-defined fields in Reevo that extend the contact record with additional data. These must be referenced by ID (not label).

​
How to send contacts from Gumloop to Reevo

Step 1: Generate a Reevo API Key

Before connecting Gumloop to Reevo, you’ll need an API key.

  1. In the Reevo app, navigate to:

    Settings → API Keys → Account & Contact Creation

  2. Click “Generate new API key.”

    In the popup, give your key a descriptive name and click Generate.

    ℹ️ If you already have an API key for Account & Contact Creation, you can reuse it — the key doesn’t need to be unique for Gumloop.

  3. Copy the key and store it somewhere secure.

    You won’t be able to access it again after closing the popup. If lost, you’ll need to generate a new one.

Step 2: Build the JSON Payload in Gumloop

  1. In your Gumloop workbook (where you’re reading contact data from Sheets or forms), add a JSON Writer node.
  2. Map the fields you want to send.
    At minimum, emailis required .

📄 Standard fields supported by Reevo’s webhook are listed here.

Step 3: Add Custom Fields (Optional)

To include custom fields like “Lead Source” or “Referral Note”:

  1. Create a second JSON Writer node.
    • Add keys using the custom field IDs (not labels).
    • You’ll get these IDs from your Reevo account manager after creating the fields in Reevo.
  2. Use the output of this JSON Writer as the value for the contact_custom_fields key in your main JSON Writer node.

Step 4: Format Nested JSON Correctly

Gumloop sometimes converts nested JSON objects into escaped strings (with extra quotes and backslashes), which can break your webhook payload.

To fix this:

  1. Create a Custom Node.
  2. Prompt it to convert the stringified JSON into a real object by removing broken formatting.

You can copy ready-to-use code here or copy the Custom Node in the workbook here.

Example Final Payload

Here’s a properly formatted JSON payload that includes both standard and custom fields:

{   
"first_name": "John",   
"last_name": "Doe",   
"email": "john.doe@acme.co",   
"contact_custom_fields": {     
	"81a18362-90d4-4d40-9e35-4943f71ee05b": "inbound_form",     
	"1c66d136-a207-4f3f-a20f-17b57cb0ad9e": "board member"   
} 
}

Step 5: Send the Payload to Reevo

  1. Add a Call API node in Gumloop.
  2. Configure it as follows:
    • URL:
      https://api.reevo.ai/api/v1/webhook/account_and_contact_creation?payload_type=JSON
    • Method: POST
    • Body: Use the formatted JSON from your Custom Node
    • Headers:
      • x-api-key: (your Reevo API key)

Step 6: Test and Run

  • Run your Gumloop workflow.
  • A 200 status code means the request was successfully processed by Reevo.

​
FAQs

Can I reuse the same API key for other tools?
Yes, if the API key was created for “Account & Contact Creation”, you can reuse it for other tools or integrations.

What happens if I lose my API key?
You won’t be able to retrieve it again. You’ll need to generate a new one from the Reevo app.

Do I need to include all contact fields in the payload?
No. Only the email field is required. You can include any additional standard or custom fields as needed.

Where do I get custom field IDs?
Custom field IDs are available from your Reevo account manager after fields have been created.

What if my JSON is malformed or nested incorrectly?
Use a Custom Node in Gumloop to fix any escaped or broken JSON formatting before sending it to Reevo.

Will the contact automatically be associated with an account in Reevo?
Yes, if account information is included and properly formatted in the payload, Reevo will associate the contact accordingly.