API Reference Overview

Integrate ArcTactic features into your custom applications using our REST API. Query contacts, create deals, and monitor AI telemetry logs programmatically.

Core Specifications

• Base URL: `https://api.arctactic.com/v1`
• Rate Limits: 60 requests per minute per IP address. Exceeding this triggers a `429 Too Many Requests` error.
• Data Format: JSON request bodies and response formats.

Authentication

Requests must include a Bearer token in the Authorization header. Retrieve your API secret token from **Settings > Developer API Keys**:

Authorization: Bearer "at_live_secret_..."

Endpoints

GET /contacts

Retrieve a list of contact records from your database. Supports filtering by email.

fetch('https://api.arctactic.com/v1/contacts', {
  headers: {
    'Authorization': 'Bearer at_live_...'
  }
})
.then(res => res.json())
.then(data => console.log(data));

POST /deals

Insert a new sales opportunity card into the pipeline. Archie will detect this card and trigger target operations.

const payload = {
  contact_id: "con_01HG",
  stage: "Intake",
  value: 12000
};

fetch('https://api.arctactic.com/v1/deals', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer at_live_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});