AZA API Documentation

Authentication

All API requests require an API key passed in the Authorization header. Each key is scoped to a single workspace — all leads and contacts created with the key appear in that workspace automatically.

Get your API key: Open AZA → Settings → Integrations → API Keys → Generate Key. The key is shown once — copy it immediately.

REQUEST HEADER

Authorization: Bearer YOUR_API_KEY

ALSO ACCEPTED (query param)

GET /zapierPing?apiKey=YOUR_API_KEY

Quick start

Create your first lead in AZA in under a minute.

1

Generate an API key — go to AZA → Settings → Integrations → API Keys

2

Test the connection — call /zapierPing with your key to confirm it's working

3

Create a lead — POST to /zapierCreateLead with firstName, lastName, email, and company

4

Check AZA — the lead appears instantly in your pipeline, scored and ready for the next Morning Brief

Test connection

Verify your API key is valid and retrieve your workspace ID.

GET /zapierPing Auth test

CURL EXAMPLE

curl -H "Authorization: Bearer YOUR_KEY" \
  https://us-central1-azaa-92ac2.cloudfunctions.net/zapierPing

Response

200 Success

{
  "ok": true,
  "workspaceId": "3YUS0CSZEpa32S1lPVjG",
  "message": "AZA connected successfully"
}

Create lead

Creates a new lead in AZA. Automatically creates a contact if one doesn't exist with the same email. Returns a 409 if a lead with that email already exists in the workspace.

POST /zapierCreateLead Creates lead + contact

Request fields

Field	Type	Required	Description
firstName	string	Required	Lead's first name
lastName	string	Required	Lead's last name
email	string	Required	Lead's email address
company	string	Required	Lead's company name
phone	string	Optional	Phone number
jobTitle	string	Optional	Job title
source	string	Optional	Lead source. Defaults to "zapier"
estimatedValue	number	Optional	Estimated deal value
notes	string	Optional	Additional notes

CURL EXAMPLE

curl -X POST \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "jane@acme.com",
    "company": "Acme Inc",
    "source": "linkedin"
  }' \
  https://us-central1-azaa-92ac2.cloudfunctions.net/zapierCreateLead

Response

201 Created

{
  "id": "abc123leadId",
  "contactId": "xyz789contactId",
  "contactCreated": true,
  "email": "jane@acme.com",
  "company": "Acme Inc",
  "status": "new",
  "source": "linkedin",
  "message": "Lead created successfully in AZA"
}

Error codes

Status	Code	Meaning
401	Invalid or inactive API key	Key doesn't exist or was deactivated
400	field is required	A required field is missing from the request
409	Lead already exists	A lead with that email already exists in the workspace
500	Internal Server Error	Contact azaaworkspace@gmail.com

Zapier integration

AZA has a native Zapier integration. Connect AZA to 7,000+ apps without writing any code.

1

Go to zapier.com → search for AZA

2

Click Connect → paste your AZA API key from Settings → Integrations

3

Choose a trigger app (LinkedIn, Typeform, Google Sheets, Facebook Ads) and map fields to AZA's Create Lead action

4

Every new lead from your external app appears instantly in AZA — scored and ready for your Morning Brief

Support: azaaworkspace@gmail.com · Website: aza-workspace.com