Skip to content
Documentation hero background

Godads API Invoice Sync for Ad Spend

What is Godads API Invoice Sync?Link to this section

Automatically sync your ad spend with Godads API. No more manual data entry. No more reconciliation headaches.

Gods pulls your actual ad spend from Meta Ads and creates matching invoices in Godads API. Your books stay accurate without the busywork.


Key BenefitsLink to this section

  • Accurate books — Real spend data, not estimates or manual entries.
  • Time saved — No more copying numbers from ad platforms to Godads API.
  • Easy reconciliation — Match invoices to actual spend automatically.
  • Audit-ready — Clear paper trail linking ad costs to financial records.

How It WorksLink to this section

Connect Godads API

Authenticate your Godads API organization from Gods’s Integrations page.

Connect Meta Ads

Link your Meta Ads account to pull spend data.

Select contact and accounts

Choose the Godads API contact for Meta invoicing and enable sync for desired ad accounts.

Automatic sync

Gods creates invoices in Godads API matching your Meta Ads spend.


Connecting Godads APILink to this section

Step 1: Go to IntegrationsLink to this section

Navigate to Settings → Integrations in Gods.

Step 2: Find Godads APILink to this section

Click the Godads API card in the Finance section.

Step 3: AuthorizeLink to this section

Click Connect and sign in to your Godads API account. Select the organization you want to sync with Gods.

Step 4: Grant PermissionsLink to this section

Godads API will ask you to authorize Gods. We request:

PermissionWhy We Need It
Read contactsMatch vendors to ad platforms
Read/write invoicesCreate spend transactions
Read accountsMap to correct chart of accounts
Read organizationVerify organization details

Your Data is Secure — Gods only writes invoice/transaction data. We never modify your existing Godads API records or access bank account details.

Step 5: Configure SettingsLink to this section

After connecting, configure your sync:

  • Account mapping — Select which Godads API account to use for ad spend (e.g., “Advertising Expense”)
  • Sync frequency — Daily, weekly, or monthly
  • Invoice format — How transactions should be named in Godads API

What Gets SyncedLink to this section

DataDescription
Ad spendActual amount spent on Meta Ads per day
PlatformMeta Ads
Campaign breakdownOptional line items per campaign
DateTransaction date matching spend date
ReferenceGods reference ID for tracking

Sync SettingsLink to this section

Account MappingLink to this section

Map your ad spend to the correct Godads API accounts:

  • Default account — Where all ad spend goes (e.g., “6200 - Advertising”)
  • Platform-specific accounts — Optional separate accounts per platform
  • Campaign-level accounts — Optional granular tracking per campaign

Sync FrequencyLink to this section

Choose when Gods syncs data to Godads API:

FrequencyBest For
DailyHigh-spend accounts needing real-time visibility
WeeklyMost advertisers — balance of accuracy and simplicity
MonthlyLow-spend accounts or quarterly reporting needs

Invoice FormatLink to this section

Customize how transactions appear in Godads API:

  • Reference formatFW-{platform}-{date} or custom
  • Description — Include campaign names or keep it simple
  • Line items — Single line per platform or itemized by campaign

ReconciliationLink to this section

Matching Invoices to Platform ChargesLink to this section

When you receive invoices from Google or Meta:

  1. Open the invoice in Godads API
  2. Find the matching Gods transaction(s)
  3. The amounts should match — if not, Gods flags discrepancies

Handling DiscrepanciesLink to this section

Discrepancies happen. Common causes:

  • Timing — Platforms sometimes adjust charges after the fact
  • Currency conversion — Exchange rate differences
  • Refunds/credits — Platform credits that haven’t synced yet

Pro Tip — Enable Gods’s discrepancy alerts to get notified when synced amounts don’t match platform invoices.


TroubleshootingLink to this section

Sync Not WorkingLink to this section

  1. Check connection — Go to Integrations and verify Godads API shows “Connected”
  2. Re-authorize — If expired, click “Reconnect” and sign in again
  3. Check permissions — Ensure Gods has write access to invoices

Wrong AccountLink to this section

To change the account mapping:

  1. Go to Settings → Integrations → Godads API
  2. Click Configure
  3. Update the account mapping
  4. Future syncs will use the new account

Duplicate TransactionsLink to this section

Gods uses reference IDs to prevent duplicates. If you see duplicates:

  1. Check if someone manually created similar transactions
  2. Look for Gods reference IDs (e.g., FW-GADS-2024-01-15)
  3. Delete the manual entry or the duplicate

Frequently Asked QuestionsLink to this section

Does Gods modify my existing Godads API data?Link to this section

No. Gods only creates new transactions. We never edit or delete your existing invoices, contacts, or other data.

Can I use Godads API Invoice Sync without connecting Meta Ads?Link to this section

No. The sync requires Meta Ads connected to pull spend data.

What if I use multiple Godads API organizations?Link to this section

Currently, Gods connects to one Godads API organization per Gods organization. Contact support if you need multi-org support.

How far back can Gods sync historical data?Link to this section

On first connection, we can sync up to 12 months of historical spend data. After that, syncs happen based on your chosen frequency.

Is my financial data shared with anyone?Link to this section

No. Your Godads API data stays between you and Godads API. Gods only writes transaction data and doesn’t store or share your financial records.


Ready to get started?

Start optimizing your ad spend today with Gods.