Integrations & Webhooks

Data & Productivity

Automation Platforms

E-commerce & Payments

Forms & Landing Pages

OAuth Integrations

1. Go to Settings → Integrations.
2. Find the integration you want and click "Connect".
3. Authorize Mailneo in the provider's OAuth flow.
4. Configure sync settings (what data to sync, frequency).
5. Enable the integration to start syncing.

API Key Integrations

1. Generate an API key in the external service.
2. Go to Settings → Integrations in Mailneo.
3. Paste the API key in the configuration.
4. Test the connection.
5. Configure sync options and save.

Outgoing Webhooks

Send HTTP requests when events occur in Mailneo:

• New subscriber added
• Subscriber unsubscribes
• Email opened or clicked
• Campaign completed
• Tag added/removed
• Custom field updated

Creating Outgoing Webhooks

1. Go to Settings → Webhooks → Create Webhook.
2. Enter the destination URL.
3. Select which events should trigger the webhook.
4. Choose HTTP method (POST, PUT, etc.).
5. Optionally add custom headers or authentication.
6. Save and test the webhook.

Webhook Payload

Webhooks send JSON data with event details:

{
  "event": "subscriber.created",
  "timestamp": "2024-12-31T10:00:00Z",
  "data": {
    "email": "john@example.com",
    "firstName": "John",
    "tags": ["new-subscriber"]
  }
}

Incoming Webhooks

Receive data from external services:

• Each webhook has a unique URL you provide to external services
• Supports signature verification for security
• Can trigger automations on receipt
• Logs all incoming requests for debugging

API Overview

The Mailneo API allows programmatic access to:

• Contacts: Create, read, update, delete
• Campaigns: Create and manage campaigns
• Newsletters: Manage lists and subscribers
• Tags: Apply and remove tags
• Analytics: Retrieve campaign metrics

Authentication

Use API keys for authentication:

1. Go to Settings → API Keys.
2. Click "Create API Key" and name your key.
3. Copy the key (it won't be shown again).
4. Include in requests: Authorization: Bearer YOUR_API_KEY

Rate Limiting

• Default limit: 100 requests per minute
• Rate limit headers included in responses
• 429 status returned when limit exceeded
• Higher limits available on Business plans

Example Request

curl -X POST https://api.mailneo.co/v1/contacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@example.com",
    "firstName": "John",
    "tags": ["api-import"]
  }'

Events That Trigger Automations

Integration events can start workflows:

• Form submission (Typeform, Tally)
• Purchase completed (Shopify, Gumroad)
• Subscription created/cancelled (Polar)
• Payment failed (Polar)
• Data synced from integration
• Custom webhook received

Common Issues