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

Confirm Connected Account Matches

This API confirms suggested matches between locations in your account and profiles from Google My Business or Facebook Pages that were previously recommended.

Behavior:

Requires base64-encoded match record IDs in a specific format, depending on the account type.
Once confirmed, the system links the location with the external listing for ongoing management.

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.matchRecordIds`	array of string	required	Array of base64 encoded match record IDs. For GMB accounts: Encode `GmbLocationMatchedData:{matchedDataDatabaseId}` For FB accounts: Encode `FbLocationMatchedData:{matchedDataDatabaseId}`

Request

curl -X POST 'https://api.synup.com/api/v4/connected-accounts/confirm-matches' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "matchRecordIds": [
      "R21iTG9jYXRpb25NYXRjaGVkRGF0YTplNGZhNTFkYi04NWEwLTRjYzItYjdmMS01OWNhMzQ1NjlhZWM=",
      "R21iTG9jYXRpb25NYXRjaGVkRGF0YSI6MWFjMDdiN2ItMjUyYi00NTdkLTlhM2ItMTk4NzEzYzNkZjQz"
    ]
  }
}'

const res = await fetch('https://api.synup.com/api/v4/connected-accounts/confirm-matches', {
  method: 'POST',
  headers: {
    Authorization: 'API YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "input": {
      "matchRecordIds": [
        "R21iTG9jYXRpb25NYXRjaGVkRGF0YTplNGZhNTFkYi04NWEwLTRjYzItYjdmMS01OWNhMzQ1NjlhZWM=",
        "R21iTG9jYXRpb25NYXRjaGVkRGF0YSI6MWFjMDdiN2ItMjUyYi00NTdkLTlhM2ItMTk4NzEzYzNkZjQz"
      ]
    }
  }),
});
const data = await res.json();

import requests
res = requests.post(
    "https://api.synup.com/api/v4/connected-accounts/confirm-matches",
    headers={
        "Authorization": "API YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
      "input": {
        "matchRecordIds": [
          "R21iTG9jYXRpb25NYXRjaGVkRGF0YTplNGZhNTFkYi04NWEwLTRjYzItYjdmMS01OWNhMzQ1NjlhZWM=",
          "R21iTG9jYXRpb25NYXRjaGVkRGF0YSI6MWFjMDdiN2ItMjUyYi00NTdkLTlhM2ItMTk4NzEzYzNkZjQz"
        ]
      }
    },
)
data = res.json()

req, _ := http.NewRequest("POST", "https://api.synup.com/api/v4/connected-accounts/confirm-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 confirmation process completed
`400`	Invalid request - Malformed base64 strings or invalid format
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Insufficient permissions

Example response (generated from the schema)

{
  "data": {
    "confirmConnectMatches": {
      "success": true,
      "failedIds": [
        "e4fa51db-85a0-4cc2-b7f1-59ca34569aec"
      ]
    }
  }
}

Response body

Name	Type	Required	Description
`data`	object	optional
`data.confirmConnectMatches`	object	optional
`data.confirmConnectMatches.success`	boolean	required	Indicates if all match records were confirmed successfully. Returns false if any match failed to confirm.
`data.confirmConnectMatches.failedIds`	array of string	optional	List of original (non-encoded) match record IDs that failed to confirm. Only present when some matches fail.