API Reference

Everything you need to integrate Etho into your application.

Base URL

https://api.etho.so

Authentication

Bearer token

Rate Limit

1000 req/min

Endpoints

POST/v1/connections

Create a new email connection for a user

GET/v1/connections/:id

Get connection status and details

DELETE/v1/connections/:id

Disconnect and delete a connection

GET/v1/objects

List all extracted data objects

GET/v1/objects/:type

Get objects by type (purchases, trips, bookings, etc.)

POST/v1/webhooks

Quick start

// Install the SDK
npm install @etho/sdk

// Initialize the client
import { Etho } from '@etho/sdk';

const etho = new Etho({
  apiKey: process.env.ETHO_API_KEY
});

// Create a connection
const connection = await etho.connections.create({
  userId: 'user_123',
  provider: 'google'
});

// Fetch extracted objects
const purchases = await etho.objects.list({
  connectionId: connection.id,
  type: 'purchase'
});

Ready to integrate?

Get your API keys and start building in minutes.