---
title: "Confirm Connected Account Matches"
method: POST
path: "/connected-accounts/confirm-matches"
tags: ["Connected Accounts"]
---

# Confirm Connected Account Matches

`POST /connected-accounts/confirm-matches`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/connected-accounts/confirm-matches`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/connected-accounts/confirm-matches/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- ConfirmMatchesRequest
  - `input` object, required
    - `matchRecordIds` string[], required: Array of base64 encoded match record IDs. For GMB accounts: Encode `GmbLocationMatchedData:{matchedDataDatabaseId}` For FB accounts: Encode `FbLocationMatchedData:{matchedDataDatabaseId}`

## Response `200`

Match confirmation process completed

- ConfirmMatchesResponse
  - `data` object
    - `confirmConnectMatches` object
      - `success` boolean, required: Indicates if all match records were confirmed successfully. Returns false if any match failed to confirm.
      - `failedIds` string[]: List of original (non-encoded) match record IDs that failed to confirm. Only present when some matches fail.

## Other responses

- `400`: Invalid request - Malformed base64 strings or invalid format
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - Insufficient permissions

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)