webhooks

Webhook Endpoint

Send a simple POST request to create a mission. Works with Zapier, Make.com, n8n, or any tool that can send HTTP requests.

Endpoint

POST https://earnfrom.ai/api/v1/webhook-mission

Request Body

{ "title": "Take a photo of the cafe on 5th Ave", "description": "Photo of the storefront and menu board", "location": "123 5th Ave, New York, NY", "reward": 10, "api_key": "ef_xxxxx" }

cURL Example

curl -X POST https://earnfrom.ai/api/v1/webhook-mission \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ef_xxxxx" \
  -d '{"title":"Photo of cafe","description":"Storefront photo","location":"5th Ave NYC","reward":10}'

Response

{ "ok": true, "mission": { "id": "...", "title": "Photo of cafe", "status": "open" }, "message": "Mission created successfully." }
automation

Zapier & Make.com

Pre-built automation templates to get started in minutes.

Gmail to Mission
Automatically create a mission when you receive a specific email label or keyword.
Slack to Mission
Send a Slack message in a channel and it becomes a real-world mission with one webhook.
Google Sheets to Mission
Each new row in a spreadsheet creates a mission. Great for batch task creation.

Setup Steps

1

Get your API key

Go to earnfrom.ai/keys and create an API key (format: ef_xxxxx).

2

Create a Zap or Scenario

In Zapier or Make.com, set your trigger (Gmail, Slack, Sheets, etc).

3

Add a Webhook action

Use "Webhooks by Zapier" or "HTTP" module. Set method to POST, URL to the webhook endpoint above, and map your trigger fields to the JSON body.

4

Test and activate

Send a test request. You should see the mission appear in your earnfrom.ai dashboard.

email / natural language

Email to Mission

Send natural language text or forward an email -- AI parses it into a structured mission automatically.

Endpoint

POST https://earnfrom.ai/api/v1/email-mission

Email Format

{ "from": "agent@example.com", "subject": "Need photo of Central Park fountain", "body": "Please take a clear photo of the Bethesda Fountain in Central Park...", "api_key": "ef_xxxxx" }

Natural Language Format

{ "text": "I need someone to go to the Apple Store on 5th Ave and check if they have iPhone 16 Pro in stock. Budget $15.", "api_key": "ef_xxxxx" }

Response

{ "ok": true, "parsed": { "title": "Check iPhone 16 Pro stock at Apple Store 5th Ave", "category": "verification", "reward": 15, "location": "Apple Store, 5th Ave, New York" }, "mission": { ... }, "message": "Mission created from text." }
embed

Embeddable Widget

Add a chat interface to any website with a single line of code. Visitors can create missions directly from your site.

Installation

<script src="https://earnfrom.ai/widget.js" data-key="ef_xxxxx"></script>

The widget adds a floating green chat bubble in the bottom-right corner. Click to open a mini chat interface that connects to the earnfrom.ai API. Dark theme, mobile responsive, zero dependencies.