Developer Documentation & SDK Hub

Platform Documentation

Everything you need to configure OAuth credentials, build cross-system visual flows, parse payloads with AI, and manage webhook ingestion.

1. Quickstart Guide

A2Z Connector allows you to create your first bi-directional automation between enterprise platforms in under 3 minutes.

  1. Connect Your Accounts: Open the Connections console and authenticate via OAuth 2.0 with Salesforce, Google, Xero, or Slack.
  2. Open the Flow Canvas: Navigate to the visual node builder at /canvas.
  3. Choose a Trigger Node: Select an event such as Salesforce Opportunity Won or Incoming Webhook.
  4. Connect Action Nodes: Drag lines to connect to Xero Create Invoice, Gmail Send Confirmation, or Slack Post Notification.
  5. Deploy & Monitor: Click Publish. Active transactions begin streaming immediately with real-time audit logging.

2. Salesforce Integration Guide

A2Z Connector communicates with Salesforce using the official JSforce Enterprise SDK, supporting both Pub/Sub Change Data Capture (CDC) events and REST/Bulk API queries.

OAuth 2.0 Web Server Flow

Connect with standard Salesforce login credentials. Tokens are automatically rotated via refresh tokens.

Streaming & CDC Triggers

Real-time event capture on Leads, Contacts, Opportunities, Accounts, and custom SObjects.

// Sample SOQL Query payload constructed in Flow Canvas SELECT Id, Name, StageName, Amount, Account.Name, CloseDate FROM Opportunity WHERE StageName = 'Closed Won'

3. Google Workspace & Gmail OAuth Configuration

A2Z Connector integrates with Google Workspace via official Google OAuth 2.0 verification standards. We request only minimum necessary scopes:

  • gmail.send: Used solely to dispatch transactional notifications and client reports generated by your flows.
  • gmail.readonly: Used solely to detect incoming emails matching your specific filter criteria (e.g. subject contains "Invoice Request").

In strict compliance with the Google API Services User Data Policy, user email content is never retained, never used to train machine learning models, and never accessible to human operators.

4. Xero Invoicing & Contact Sync

Connect Xero to automate debtor management, tax calculation, and invoice creation directly from CRM deals.

  • Automatic Contact Matching: Matches customer email in Salesforce to existing Xero Contacts to prevent duplicates.
  • Line Item Mapping: Maps Opportunity Line Items to Xero Account Codes and Tax Types.
  • Status Tracking: Automatically detects when invoices are marked Paid in Xero and writes payment receipts back to Salesforce.

5. Slack Bot & Webhook Integration

Send interactive Block-Kit messages, approval buttons, and deal notifications directly to your team's Slack channels.

// Sample Block-Kit JSON generated by A2Z Connector { "channel": "#sales-wins", "blocks": [ { "type": "section", "text": { "type": "mrkdwn", "text": "🚀 *New Closed-Won Deal!* $54,000 from Acme Corp" } } ] }

6. Stripe Webhook Ingestion

Listen for real-time Stripe customer charge events, failed subscription renewals, and invoice payments. Every webhook payload is cryptographically validated using your endpoint signing secret (whsec_...) before initiating downstream CRM operations.

7. Flow Canvas Node Architecture

The A2Z Connector visual builder supports rich architectural logic:

  • Trigger Nodes: Webhook listener, polling timer, or event listener (Salesforce CDC, Stripe event).
  • Condition & Branching Nodes: Route executions down True/False paths based on value comparisons (e.g. deal.amount > 10000).
  • AI Transform Nodes: Use OpenAI to extract sentiment, summarize notes, or auto-categorize inbound requests.
  • Loop & Map Nodes: Iterate across arrays of line items or contacts effortlessly.

8. Understanding Execution Credits

A2Z Connector uses a predictable, fair-billing unit called Execution Credits:

  • 1 Standard API Step = 1 Credit: Performing a Salesforce query, creating a Xero invoice, or sending a Slack message consumes 1 credit.
  • Triggers are Free: Webhooks waiting on events, or polling checks that discover no new data, consume 0 credits.
  • Rollover Guarantee: Unused credits from your monthly plan roll over to the following billing cycle.