---
title: "Retrieve the url of a sync for a specific consumer"
method: POST
path: "/consumers/{consumer_id}/syncs"
tags: ["Consumers"]
---

# Retrieve the url of a sync for a specific consumer

`POST /consumers/{consumer_id}/syncs`

This route can be used to retrieve the url that can be shared with your clients to allow them to connect as specified in a sync

## Path parameters

- `consumer_id` string, uuid, required

## Request body

- CreateConsumerSyncItem
  - `syncid` string, uuid, required
  - `integrationids` string[], nullable — [OPTIONAL] Can be used to specify maximum one integrationid for each One API that you want to highlight. If specified, only this connector will be displayed to your clients.
  - `country` string, nullable — ISO 3166-1 alpha-2 country code to filter connectors by country. Ignored if integrationids are provided.
  - `link_metadata` object, nullable

## Response `200`

Successful Response

- LinkSyncItem
  - `url` string, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/chift/apis/chift-api.md) · [All operations](https://skmtc.net/chift/apis/chift-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chift/chift-api/revisions/b5f1214a482a/schema)