Zapier API Documentation — Banana Cards

Integrate Banana Cards with your existing workflows using the Zapier API. This guide covers authentication, available triggers and actions, field mapping, and best practices for managing rate limits.

Authentication

To authenticate your requests, include your API key in the Authorization header. Replace [your_key] with your actual live secret key.

Authorization: Bearer bk_live_[your_key]

Triggers and Actions

Triggers

• contact.created: Fires automatically whenever a new contact is added or imported into your account.

Actions

• Create Contact: Adds a new contact record with support for tags and custom fields.

API Reference: Create Contact

Endpoint: POST /v1/contacts

Request Example

{
  "full_name": "Sara Lin",
  "email": "sara@acme.com",
  "phone": "+15551234",
  "company": "Acme",
  "title": "Head of Ops",
  "tags": ["saastr-2026", "warm"],
  "lifecycle_stage": "lead",
  "owner_email": "me@banana.cards",
  "custom_fields": {
    "source_event": "SaaStr 2026",
    "budget": "10k"
  }
}

Response Example

{
  "id": "ct_2N91...",
  "created_at": "2026-05-15T10:24:31Z",
  "url": "https://app.banana.cards/contacts/ct_2N91..."
}

Field Mapping Table

Banana Cards supports various data types. Ensure your Zapier mapping aligns with these formats:

Data Category	Supported Types
Text/Media	text, email, phone, url
Numbers	number, currency
Time/Date	date, datetime
Selection	select (single), multiselect (arrays)
Logic	boolean
Tags	tag (Automatically created if they do not exist)
Files	Pass a public URL; Banana Cards will copy it to secure storage

Rate Limits

Limits are applied based on your subscription tier. If you exceed these limits, you will receive a 429 Too Many Requests status code. Zapier typically handles these via automatic exponential backoff.

• Free Plan: 30 req/min | 1,000 req/day
• Teams Plan: 120 req/min | 25,000 req/day
• Enterprise: Custom limits available

Error Handling

In the event of an error, the API will return a structured JSON response identifying the issue.

Common Error Codes:

• unauthorized / forbidden
• not_found
• validation_error
• rate_limited
• server_error

Error Response Example

{
  "error": {
    "code": "validation_error",
    "message": "email must be a valid address",
    "field": "email"
  }
}

Need Help?

If you encounter any issues during your technical setup, please reach out to our support team:

• Email: hello@banana.cards
• Subject: Zapier API Support