For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inBook a demo
GuidesAPI Reference
GuidesAPI Reference
  • Getting started
    • Introduction
    • IP Whitelisting
    • Obtaining API keys
    • LLMs.txt
    • MCP server
    • Quickstart
    • Native clients
    • Concepts
    • Embedding authentication
    • Versioning
    • Idempotent requests
    • Events
    • Self-hosted option
    • 2025-09-18 Migration Guide
  • Configuring your connections
    • Overview
      • Affinity
      • Airtable
      • Amazon Selling Partner
      • Amplemarket
      • Amplitude
      • Apollo.io
      • App Store Connect
      • Appcues
      • AppsFlyer
      • Asana
      • Ascend
      • Ashby
      • Attio
      • Auth0
      • Autumn
      • Autura
      • AWS Athena
      • AWS OpenSearch
      • Azure Blob Storage
      • Azure Cosmos DB
      • Azure SQL
      • Azure Synapse
      • Barbour ABI
      • Baseten
      • Botpress
      • Brevo
      • Calendly
      • CallRail
      • Campfire
      • Chameleon
      • Chargebee
      • Chili Piper
      • Chorus
      • Circle
      • Clari Copilot
      • Clazar
      • Clerk
      • ClickHouse
      • Cloudflare Logs
      • Cloudflare R2
      • CloudTalk
      • Construct Connect
      • ConstructionWire
      • CSV URL
      • Customer.io
      • Customer.io Warehouse Exports
      • Databricks
      • Datadog
      • Dayforce
      • dbt Cloud
      • dbt Project Repository
      • DealCloud
      • Delighted
      • Dialpad
      • Dittofeed
      • Docker Hub
      • Dropbox
      • Dub
      • DynamoDB
      • Facebook Ads
      • Factors.ai
      • Fathom
      • Fireflies.ai
      • Freshdesk
      • Freshservice
      • Front
      • Fullstory
      • G2
      • Gainsight CS
      • Gatsby
      • GitHub
      • Gladly
      • Glean
      • Gmail
      • Gong
      • Google Ads
      • Google Analytics
      • Google BigQuery
      • Google Cloud MySQL
      • Google Cloud PostgreSQL
      • Google Cloud Storage
      • Google Search Console
      • Google Sheets
      • Google Slides
      • Google Workspace
      • Gorgias
      • Greenhouse
      • Harmonic
      • Heap
      • Heron Data
      • HeyReach
      • HighLevel
      • Highspot
      • Honeycomb
      • HTTP API
      • HTTP Enrichment
      • HubSpot
      • Hyperline
      • IBM Db2
      • Instantly
      • Intellimize
      • Intercom
      • Ironclad
      • Iterable
      • Jira
      • Juro
      • Klaviyo
      • Knock
      • Kustomer
      • Lago
      • LearnWorlds
      • Linear
      • LinkedIn Ads
      • Lob
      • Loop
      • Loops
      • Luma
      • m3ter
      • MailerCheck
      • Marketo
      • Microsoft Ads
      • Microsoft Dynamics 365
      • Microsoft SharePoint Excel
      • Microsoft SQL Server
      • Mixpanel
      • monday.com
      • MongoDB
      • MotherDuck
      • MySQL
      • n8n
      • NetSuite
      • NetSuite OpenAir
      • NetSuite SuiteAnalytics
      • Northbeam
      • Notion
      • Outreach
      • Pardot
      • PartnerPage
      • Paycor
      • Pinterest Ads
      • Pipedrive
      • Pitchbook
      • Plain
      • PlusVibe
      • Polytomic Metadata
      • PostgreSQL
      • PostHog
      • PredictLeads
      • Productboard
      • Profound
      • Pylon
      • QtaniumConnect
      • Qualtrics
      • QuickBooks
      • Ramp
      • Recharge
      • Reddit Ads
      • Redshift
      • Redshift Serverless
      • Reo.dev
      • Reply
      • Rewardful
      • Rippling
      • Rocketlane
      • S3
      • Sage Intacct
      • Salesbricks
      • Salesforce
      • Salesloft
      • Scamalytics
      • ScyllaDB
      • Seal Subscriptions
      • Seam AI
      • Segment
      • Seismic
      • SFTP
      • ShipBob
      • Shippo
      • Shopify
      • Short.io
      • Showpad
      • Slack
      • Smartlead.ai
      • Smartsheet
      • Snowflake
      • Sprig
      • Sprout Social
      • Standard Metrics
      • Statsig
      • Stord
      • Strackr
      • Stripe
      • SurveyMonkey
      • Survicate
      • Tabs
      • TestRail
      • Thrive
      • Tigris
      • TikTok Ads
      • Tixr
      • Towbook
      • Twilio Sendgrid
      • Typeform
      • Unbounce
      • Upfluence
      • UpPromote
      • UserVoice
      • Vanilla Forums
      • Walmart Marketplace
      • Ware2Go
      • Webhook
      • WorkOS
      • Xero
      • Yotpo
      • YouTube Analytics
      • Zendesk Chat
      • Zendesk Support
      • Zoho CRM
      • Zoho Desk
      • ZoomInfo
    • CDC streaming from databases
    • Syncing to custom webhooks
  • Code examples
    • Overview
    • Bulk sync (ELT) from HubSpot to PostgreSQL
    • Bulk sync (ELT) from Salesforce to S3
    • Bulk sync (ELT) from Salesforce to Snowflake
    • Model sync (Reverse ETL) from Snowflake query to Salesforce
    • Model sync (Reverse ETL) from MongoDB to Salesforce
    • Adding users from Snowflake to Salesloft Cadence
    • Adding contacts from Snowflake to Gong Engage
    • Joined model sync from Postgres, Airtable, and Stripe to Hubspot
    • Model sync from MySQL to Snowflake
    • Model sync from Salesforce to Netsuite
    • Querying Salesforce using SOQL
    • Syncing audiences from Snowflake to LinkedIn Ads
    • Syncing contacts from Google Cloud Storage to Salesforce
    • Syncing contacts from Google Cloud Storage to webhooks
  • Terraform examples
    • Overview
    • Model sync (Reverse ETL) from BigQuery to Salesforce
    • Model sync (Reverse ETL) from BigQuery to LinkedIn Ads
Logo
Log inBook a demo
On this page
  • Connection
  • Configuration
  • Example
  • Model Sync
  • Source
  • Configuration
  • Example
  • Target
  • All targets
  • Configuration
  • Example
  • Target creation
  • Bulk Sync
  • Source
  • Configuration
  • Example
  • Destination
  • Configuration
  • Example
  • Type handling
  • Destination types
  • Source types
Configuring your connectionsConnection configurations

Google Cloud PostgreSQL

Was this page helpful?
Previous

Google Cloud Storage

Next

Supports:

  • ✅ Models
  • ✅ Model sync destination
  • ✅ Bulk sync source
  • ✅ Bulk sync destination

Connection

Configuration

NameTypeDescriptionRequired
change_detectionbooleanUse logical replication for bulk syncs ↓false
connection_namestringCloud SQL connection name

Takes the form of project:region:instance
true
credentialsstringService account keytrue
databasestringDatabasetrue
passwordstringPassword

May be omitted when authenticating to Postgres using the service account key.
false
usernamestringUsernamefalse

change_detection

When change_detection is true
NameTypeDescriptionRequired
publicationstringPublicationfalse

Example

1{
2 "name": "Google Cloud PostgreSQL connection",
3 "type": "googlecloudsql",
4 "configuration": {
5 "change_detection": false,
6 "connection_name": "project:region:instance",
7 "credentials": "",
8 "database": "sampledb",
9 "password": "secret",
10 "username": "cloudsql"
11 }
12}

Model Sync

Source

Configuration

NameTypeDescriptionRequired
querystringfalse
tablestringTablefalse
viewstringViewfalse

Example

1{
2 ...
3 "configuration": {
4 "query": "SELECT * from users",
5 "table": "users",
6 "view": "active_users"
7 }
8}

Target

Google Cloud PostgreSQL connections may be used as the destination in a model sync.

All targets

Configuration
NameTypeDescriptionRequired
created_columnstring’Created at’ timestamp columnfalse
preserve_table_on_resyncbooleanPreserve destination table when resyncingfalse
updated_columnstring’Updated at’ timestamp columnfalse
write_null_valuesbooleanCopy null values

When enabled updates will set fields to NULL when the source value is null
false
write_record_timestampsbooleanWrite row timestamp metadatafalse
Example
1{
2 ...
3 "target": {
4 "configuration": {
5 "created_column": "",
6 "preserve_table_on_resync": false,
7 "updated_column": "",
8 "write_null_values": false,
9 "write_record_timestamps": false
10 }
11 }
12}

Target creation

Google Cloud PostgreSQL connections may be used to create a new target for a model sync. The following parameters are required to create a new target:

NAMEDESCRIPTIONENUM
nameTable namefalse

Bulk Sync

Source

Configuration

NameTypeDescriptionRequired
automatically_add_new_fieldsbooleanAutomatically add new fields on selected tablesfalse
automatically_add_new_objectsbooleanAutomatically add new tablesfalse
mirror_publication_selectionsbooleanMirror table and column selection with database publicationfalse
mirror_tables_without_unique_idbooleanMirror table without a unique identifier

If set to true
false
replication_slotstringReplication slot

Leave blank to allow Polytomic to manage a replication slot for this sync.
false

Example

1{
2 ...
3 "source_configuration": {
4 "automatically_add_new_fields": false,
5 "automatically_add_new_objects": false,
6 "mirror_publication_selections": false,
7 "mirror_tables_without_unique_id": false,
8 "replication_slot": "polytomic"
9 }
10}

Destination

Configuration

NameTypeDescriptionRequired
advancedobjectfalse
mirror_schemasbooleanMirror schemasfalse
schemastringOutput schemafalse

Example

1{
2 ...
3 "destination_configuration": {
4 "advanced": {
5 "empty_strings_null": false,
6 "hard_deletes": false,
7 "initial_execution": "",
8 "table_prefix": "",
9 "truncate_existing": false
10 },
11 "mirror_schemas": false,
12 "schema": "schema"
13 }
14}

Type handling

Destination types

POLYTOMIC TYPEGOOGLE CLOUD POSTGRESQL TYPE
array<>JSON
bigintINT8
booleanBOOL
dateDATE
datetimeTIMESTAMP
decimal(precision, scale)NUMERIC(precision,scale)
doubleDOUBLE PRECISION
intINT4
jsonJSON
jsonarrayJSON
numberNUMERIC
object{}JSON
singleREAL
smallintINT2
stringTEXT
timeTIME

Source types

GOOGLE CLOUD POSTGRESQL TYPEPOLYTOMIC TYPE
ANYARRAYjsonarray
CIDRstring
CSTRINGstring
DATEdate
DOUBLE PRECISIONdouble
FLOATsingle
FLOAT4single
FLOAT8double
INETstring
INTint
INT2smallint
INT4int
INT8bigint
INTERVALstring
JSONjson
JSONBjson
MACADDRstring
MONEYnumber
NAMEstring
NUMERIC(precision, scale)decimal(precision, scale)
REALsingle
TEXTstring
TIMEtime
TIMESTAMPdatetime
TIMESTAMPTZdatetime_tz
TIMETZtime
UUIDstring
_BOOLjsonarray
_BPCHARjsonarray
_BYTEAjsonarray
_CHARjsonarray
_CSTRINGjsonarray
_DATEjsonarray
_FLOAT4jsonarray
_FLOAT8jsonarray
_INT2jsonarray
_INT2VECTORjsonarray
_INT4jsonarray
_INT8jsonarray
_JSONjsonarray
_JSONBjsonarray
_LSEGjsonarray
_MONEYjsonarray
_NAMEjsonarray
_NUMERICjsonarray
_PATHjsonarray
_TEXTjsonarray
_TIMEjsonarray
_TIMESTAMPjsonarray
_TIMESTAMPTZjsonarray
_TIMETZjsonarray
_UUIDjsonarray
_VARCHARjsonarray
_XMLjsonarray