Workflow Integrations

GET

api

workflows

integrations

curl --request GET \
  --url https://encrata.com/api/workflows/integrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integration": "<string>",
  "connection_id": "<string>",
  "provider_config_key": "<string>",
  "label": "<string>",
  "title": "<string>"
}
'

import requests

url = "https://encrata.com/api/workflows/integrations"

payload = {
    "integration": "<string>",
    "connection_id": "<string>",
    "provider_config_key": "<string>",
    "label": "<string>",
    "title": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.get(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    integration: '<string>',
    connection_id: '<string>',
    provider_config_key: '<string>',
    label: '<string>',
    title: '<string>'
  })
};

fetch('https://encrata.com/api/workflows/integrations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://encrata.com/api/workflows/integrations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'integration' => '<string>',
    'connection_id' => '<string>',
    'provider_config_key' => '<string>',
    'label' => '<string>',
    'title' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://encrata.com/api/workflows/integrations"

	payload := strings.NewReader("{\n  \"integration\": \"<string>\",\n  \"connection_id\": \"<string>\",\n  \"provider_config_key\": \"<string>\",\n  \"label\": \"<string>\",\n  \"title\": \"<string>\"\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://encrata.com/api/workflows/integrations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"integration\": \"<string>\",\n  \"connection_id\": \"<string>\",\n  \"provider_config_key\": \"<string>\",\n  \"label\": \"<string>\",\n  \"title\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://encrata.com/api/workflows/integrations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"integration\": \"<string>\",\n  \"connection_id\": \"<string>\",\n  \"provider_config_key\": \"<string>\",\n  \"label\": \"<string>\",\n  \"title\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Overview

Integrations are the connected destinations your workflow Export steps send enriched records to. Connections are made through a self-hosted Nango instance, which handles OAuth and token refresh, so Encrata never stores the third-party credentials. Each connection is referenced by a connection_id and a provider_config_key (for example google-sheet, hubspot, salesforce).

Authentication

Requires a JWT token or API key in the Authorization header.

Authorization: Bearer YOUR_TOKEN

List Integrations

GET /api/workflows/integrations

Returns the connected accounts for the current user.

Example response

{
  "integrations": [
    {
      "id": "int_abc123",
      "provider": "nango",
      "account_email": "My HubSpot",
      "status": "connected",
      "provider_config_key": "hubspot",
      "created_at": "2026-07-29T10:00:00Z"
    }
  ]
}

List Available Providers

GET /api/workflows/integrations/nango/providers

Returns the apps configured on the connected Nango instance, ready to connect.

Start a Connection

POST /api/workflows/integrations/nango/session

Returns a short-lived Connect session token used by the dashboard to open the Nango Connect UI. In the dashboard this is handled for you on the Integrations page. The returned token, host, and connect_url are passed to the Nango frontend SDK.

string

Optional provider config key to restrict the connect flow to a single app.

Save a Connection

POST /api/workflows/integrations/nango/save

Records a completed connection after the Connect UI flow finishes.

string

required

The Nango connection id returned by the Connect UI.

string

required

The provider config key (for example google-sheet).

string

Optional friendly name shown in the dashboard.

Disconnect

DELETE /api/workflows/integrations/{id}

Removes a connected account. Existing Export steps that reference it will stop delivering until reconnected.

Create a Google Sheet

POST /api/workflows/integrations/{id}/sheet

Creates a new spreadsheet in the connected Google account and returns its id, so an Export step can write to it without pasting a spreadsheet URL.

string

Optional spreadsheet title. Defaults to a generated name.

Example response

{
  "spreadsheet_id": "1AbCdEf...",
  "spreadsheet_url": "https://docs.google.com/spreadsheets/d/1AbCdEf.../edit",
  "sheet_name": "Sheet1"
}

Workflow Templates

List Monitors

Workflow Integrations

curl --request GET \
  --url https://encrata.com/api/workflows/integrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integration": "<string>",
  "connection_id": "<string>",
  "provider_config_key": "<string>",
  "label": "<string>",
  "title": "<string>"
}
'

import requests

url = "https://encrata.com/api/workflows/integrations"

payload = {
    "integration": "<string>",
    "connection_id": "<string>",
    "provider_config_key": "<string>",
    "label": "<string>",
    "title": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.get(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    integration: '<string>',
    connection_id: '<string>',
    provider_config_key: '<string>',
    label: '<string>',
    title: '<string>'
  })
};

fetch('https://encrata.com/api/workflows/integrations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://encrata.com/api/workflows/integrations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'integration' => '<string>',
    'connection_id' => '<string>',
    'provider_config_key' => '<string>',
    'label' => '<string>',
    'title' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://encrata.com/api/workflows/integrations"

	payload := strings.NewReader("{\n  \"integration\": \"<string>\",\n  \"connection_id\": \"<string>\",\n  \"provider_config_key\": \"<string>\",\n  \"label\": \"<string>\",\n  \"title\": \"<string>\"\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://encrata.com/api/workflows/integrations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"integration\": \"<string>\",\n  \"connection_id\": \"<string>\",\n  \"provider_config_key\": \"<string>\",\n  \"label\": \"<string>\",\n  \"title\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://encrata.com/api/workflows/integrations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"integration\": \"<string>\",\n  \"connection_id\": \"<string>\",\n  \"provider_config_key\": \"<string>\",\n  \"label\": \"<string>\",\n  \"title\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Overview

Email Lookup

Bulk Operations

Workflows

Monitors

Contact Lists

API Keys

Webhooks

Resources

Workflow Integrations

Overview

Authentication

List Integrations

Example response

List Available Providers

Start a Connection

Save a Connection

Disconnect

Create a Google Sheet

Example response

​Overview

​Authentication

​List Integrations

​Example response

​List Available Providers

​Start a Connection

​Save a Connection

​Disconnect

​Create a Google Sheet

​Example response

Overview

Authentication

List Integrations

Example response

List Available Providers

Start a Connection

Save a Connection

Disconnect

Create a Google Sheet

Example response