---
title: "Trigger New Matches"
method: POST
path: "/connected-accounts/trigger-matches"
tags: ["Connected Accounts"]
---

# Trigger New Matches

`POST /connected-accounts/trigger-matches`

## Request

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

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.

## Headers

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

## Request body

- TriggerMatchesRequest
  - `input` object, required
    - `connectedAccountIds` string[], required: List of connected account IDs to process

## Response `200`

Match triggering process initiated

- TriggerMatchesResponse
  - `data` object
    - `connectedAccountsTriggerMatches` object
      - `success` boolean, required: Indicates if all connected accounts were processed successfully. Returns false if any account failed to process.
      - `failedIds` string[]: List of connected account IDs that failed to process

## Other responses

- `400`: Invalid request - Missing or invalid parameters
- `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)