POSTapi.synup.com/api/v4/connected-accounts/trigger-matches

Trigger New Matches

This API fetches all locations from connected Google My Business and Facebook Page profiles and attempts to match them with locations in your account.

Behavior:

Supports batch processing – multiple connected accounts can be processed in a single request.
Matches locations based on business name, address, and other identifying attributes.
Helps ensure consistency between external platforms and your account.

Requires an API key. Send it as Authorization: API <your-key> — see Getting started.

Parameters

Headers

Name	Type	Required	Description
`Content-Type`	string	required

Body

Name	Type	Required	Description
`input`	object	required
`input.connectedAccountIds`	array of string	required	List of connected account IDs to process

Request

curl -X POST 'https://api.synup.com/api/v4/connected-accounts/trigger-matches' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "connectedAccountIds": [
      "6eb312f7-df32-4d76-ad8a-26bcfeab601e",
      "7eb3q2f7-df34-4dt6-hd88-269cfoal6m1b"
    ]
  }
}'

const res = await fetch('https://api.synup.com/api/v4/connected-accounts/trigger-matches', {
  method: 'POST',
  headers: {
    Authorization: 'API YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "input": {
      "connectedAccountIds": [
        "6eb312f7-df32-4d76-ad8a-26bcfeab601e",
        "7eb3q2f7-df34-4dt6-hd88-269cfoal6m1b"
      ]
    }
  }),
});
const data = await res.json();

import requests
res = requests.post(
    "https://api.synup.com/api/v4/connected-accounts/trigger-matches",
    headers={
        "Authorization": "API YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
      "input": {
        "connectedAccountIds": [
          "6eb312f7-df32-4d76-ad8a-26bcfeab601e",
          "7eb3q2f7-df34-4dt6-hd88-269cfoal6m1b"
        ]
      }
    },
)
data = res.json()

req, _ := http.NewRequest("POST", "https://api.synup.com/api/v4/connected-accounts/trigger-matches", bytes.NewBufferString(payload))
req.Header.Set("Authorization", "API YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")

res, err := http.DefaultClient.Do(req)

Responses

Status	Description
`200`	Match triggering process initiated
`400`	Invalid request - Missing or invalid parameters
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Insufficient permissions

Example response (generated from the schema)

{
  "data": {
    "connectedAccountsTriggerMatches": {
      "success": true,
      "failedIds": [
        "7eb3q2f7-df34-4dt6-hd88-269cfoal6m1b"
      ]
    }
  }
}

Response body

Name	Type	Required	Description
`data`	object	optional
`data.connectedAccountsTriggerMatches`	object	optional
`data.connectedAccountsTriggerMatches.success`	boolean	required	Indicates if all connected accounts were processed successfully. Returns false if any account failed to process.
`data.connectedAccountsTriggerMatches.failedIds`	array of string	optional	List of connected account IDs that failed to process