Integration Yanta- A Comprehensive Tutorial

What Is Integration Yanta?

Integration Yanta is an API-first integration platform that connects your business tools without requiring a team of developers. If you've been manually moving data between apps or paying through the nose for custom integrations, Yanta solves that problem.

You connect your apps, define your data flows, and Yanta handles the rest. It's that straightforward.

Core Features You Need to Know

Before diving in, understand what Yanta actually does:

Getting Started With Yanta

Step 1: Create Your Account

Sign up at yanta.io. The free tier gives you 5 active flows and 10,000 API calls per month. That's enough to test things out before committing.

Step 2: Connect Your First App

Navigate to Connections and click Add Connection. Select your app from the list. Yanta will redirect you to authenticate with OAuth or API keys, depending on the service.

Most popular apps use OAuth 2.0, so you'll authorize Yanta to access your account. Give it only the permissions it needs.

Step 3: Build Your First Flow

Go to Flows and click Create Flow. A flow has three parts:

Example: When a new row is added to Google Sheets, create a customer record in HubSpot and send a Slack message.

Working With the Yanta API

When pre-built connectors don't work, use the API directly. Yanta exposes REST endpoints for everything.

Authentication

All API requests require an API key. Find yours under Settings → API Keys. Pass it in the header:

Authorization: Bearer YOUR_API_KEY

Key Endpoints

Method Endpoint Purpose
GET /v1/flows List all your flows
POST /v1/flows Create a new flow
GET /v1/flows/{id} Get flow details
PUT /v1/flows/{id} Update a flow
DELETE /v1/flows/{id} Delete a flow
POST /v1/flows/{id}/run Trigger flow manually
GET /v1/logs View execution history

Creating a Flow via API

Send a POST request to /v1/flows with your flow definition:

{
  "name": "Lead Sync",
  "trigger": {
    "type": "webhook",
    "source": "custom"
  },
  "steps": [
    {
      "type": "transform",
      "mapping": {
        "email": "{{trigger.email}}",
        "name": "{{trigger.firstName}} {{trigger.lastName}}"
      }
    }
  ],
  "action": {
    "type": "hubspot",
    "operation": "create_contact",
    "api_key": "YOUR_HUBSPOT_KEY"
  }
}

The response returns your new flow ID. Save it — you'll need it to trigger runs or make updates.

Data Transformation Basics

Yanta uses double-brace syntax for variable substitution. When data enters your flow, you reference it like {{trigger.fieldName}}.

Common transformations:

For complex transformations, Yanta supports JavaScript snippets directly in your flow steps.

Webhook Configuration

To receive data from external systems, create a webhook trigger. Yanta gives you a unique URL:

https://hooks.yanta.io/v1/receive/{UNIQUE_ID}

Send POST requests to this URL from your source app. Yanta accepts JSON, form-encoded, or XML payloads. Configure the payload format under Trigger Settings → Payload Type.

Verifying Webhook Signatures

If your source app sends signatures for verification, enable Signature Verification in trigger settings. Yanta validates HMAC-SHA256 signatures automatically and rejects requests with invalid signatures.

Error Handling and Retries

Yanta retries failed steps automatically. Default behavior:

Override this per step. In your flow editor, click a step → Advanced → Retry Policy.

You can also set custom error paths. If a step fails, route to a different action instead of halting the flow entirely.

Monitoring and Debugging

Every flow execution logs to Logs. You'll see:

Click any log entry to inspect the raw data at each stage. This is where you debug broken mappings or unexpected data formats.

Pricing Tiers Compared

Feature Free Pro ($49/mo) Enterprise (Custom)
Active flows 5 50 Unlimited
Monthly API calls 10,000 500,000 Unlimited
Custom API endpoints
SSO
Dedicated support Email only
SLA guarantee 99.9% Custom

Common Pitfalls

Rate limits. Yanta and your connected apps both have rate limits. Check the logs when flows suddenly fail. If you're hitting limits, add delays between steps or batch operations.

Field mapping errors. If a field doesn't exist in your payload, the mapping returns empty. Always check your trigger payload in the logs first.

OAuth token expiry. Some integrations require token refreshes. If a connection breaks after weeks of working, re-authenticate under Connections.

Payload size limits. Webhook payloads over 1MB get rejected. If you're sending large files, use Yanta's file storage step and pass URLs instead.

When to Use Yanta vs. Alternatives

Yanta works well when:

Look elsewhere when:

Quick Start Checklist

That's it. From there, expand based on what your business actually needs.