Connect your app

SELDA_API_KEY=sk_live_...
SELDA_PROJECT_ID=...

curl -X POST https://api.selda.ai/mcp/mutate \
  -H "Authorization: Bearer $SELDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fn": "leads.add",
    "args": {
      "projectId": "'"$SELDA_PROJECT_ID"'",
      "company": "Acme Oy",
      "email": "owner@acme.fi",
      "companyDomain": "acme.fi",
      "source": "my-app"
    }
  }'

{ "value": { "leadId": "...", "duplicate": false } }

await fetch("https://api.selda.ai/mcp/mutate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SELDA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    fn: "leads.add",
    args: {
      projectId: process.env.SELDA_PROJECT_ID,
      company: "Acme Oy",
      email: "owner@acme.fi",
      companyDomain: "acme.fi",
      notes: "views:1200 · no_video:true",
      source: "my-app",
    },
  }),
});

# 1. Create campaign
POST /mcp/mutate  { "fn": "campaigns.create", "args": { "projectId": "...", "name": "Q3 push", "leadCount": 30 } }
 
# 2. Run engine (finds leads, writes messages, waits for approval, nothing sends automatically)
POST /mcp/run     { "fn": "engine.start", "args": { "projectId": "..." } }

await fetch("https://api.selda.ai/mcp/mutate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SELDA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    fn: "leads.add",
    args: {
      projectId: process.env.SELDA_PROJECT_ID,
      company: "Acme Oy",
      companyDomain: "acme.fi",
      // Your write-up (markdown or plain text). The message stays faithful to it. // Selda never invents specifics beyond what you provide here.
      analysis: "Acme builds industrial IoT sensors. Opened a Munich office in Q1 2026 " +
                "and is hiring field engineers, a clear expansion signal to lead with.",
      source: "claude",
    },
  }),
});

curl -X POST https://api.selda.ai/mcp/query \
  -H "Authorization: Bearer $SELDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fn":"campaigns.stats","args":{"campaignId":"..."}}'
# → { "value": { "sent": 42, "replies": 7, "meetings": 2 } }

curl -X POST https://api.selda.ai/mcp/mutate \
  -H "Authorization: Bearer $SELDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fn": "webhooks.create",
    "args": {
      "url": "https://your-app.com/selda/events",
      "events": ["reply.received", "lead.status_changed"],
      "description": "My app"
    }
  }'
# → { "value": { "webhookId": "...", "secret": "whsec_..." } }

{
  "event": "reply.received",
  "timestamp": 1720000000000,
  "data": {
    "inboundMessageId": "...",
    "leadId": "...",
    "email": "owner@acme.fi",
    "company": "Acme Oy",
    "campaignId": "...",
    "from": "owner@acme.fi",
    "subject": "Re: Quick question",
    "classification": "positive"
  }
}

const crypto = require('crypto')
 
function verifySeldaWebhook(secret, rawBody, signatureHeader) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex')
  return crypto.timingSafeEqual(Buffer.from(signatureHeader), Buffer.from(expected))
}
 
// Express
app.post('/selda/events', express.raw({ type: 'application/json' }), (req, res) => {
  if (!verifySeldaWebhook(
    process.env.SELDA_WEBHOOK_SECRET,
    req.body,
    req.headers['x-selda-signature']
  )) return res.status(401).send('Bad signature')
 
  const { event, data } = JSON.parse(req.body)
  // handle...
  res.sendStatus(200)
})

curl -X POST https://api.selda.ai/mcp/mutate \
  -H "Authorization: Bearer $SELDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fn": "connectors.create",
    "args": {
      "projectId": "...",
      "name": "My App",
      "url": "https://api.myapp.com/customers",
      "authHeader": "Bearer sk_...",
      "fieldMap": {
        "company": "companyName",
        "email": "ownerEmail",
        "companyDomain": "website",
        "notes": "city"
      }
    }
  }'

# Append to existing knowledge
POST /mcp/mutate
{
  "fn": "knowledge.append",
  "args": {
    "projectId": "...",
    "text": "We sell media packages: video production 990€, distribution to 14k daily readers. Target: terrace restaurants without a video yet."
  }
}

POST /mcp/mutate
{
  "fn": "campaign.updatePlaybook",
  "args": {
    "runId": "...",
    "appendText": "Prioritise restaurants with views > 1000 but no video yet."
  }
}

Authorization: Bearer sk_live_...

1. New restaurant on terassikesa.fi
   → POST /mcp/mutate  fn=leads.add
     { company: "Huvila Ranta", email: "jani@huvila.fi", notes: "views:1200 · no_video:true" }

2. Selda engine runs, finds contact, writes personalised message, waits for approval

3. You approve in the Selda app → Selda sends

4. Jani replies → Selda fires webhook:
   POST https://adventurous-bear-355.eu-west-1.convex.site/webhooks/selda
   {
     "event": "reply.received",
     "data": {
       "company": "Huvila Ranta",
       "email": "jani@huvila.fi",
       "classification": "positive",
       "campaignId": "..."
     }
   }

5. Your backend marks the restaurant as a hot lead