---
title: "Initiate Contacts/History Synchronization"
method: POST
path: "/app/{appId}/coex/sync"
tags: ["Partner Linked Application"]
---

# Initiate Contacts/History Synchronization

`POST /app/{appId}/coex/sync`

Initiates one-time synchronization for the app.

- Use `syncType=smb_app_state_sync` to initiate contacts synchronization. On success, `smb_app_state_sync` webhooks are triggered for current contacts and future contact updates.
- Use `syncType=history` to initiate message history synchronization. If the business has shared history, `history` webhooks are triggered.

Important:
- This step can be performed only once.
- To perform again, customer must offboard and complete Embedded Signup again.

## Path parameters

- `appId` string, required

## Response `200`

Sync request accepted successfully

- object
  - `data` object, required
    - `messaging_product` string, required
    - `request_id` string, required — Identifier for the sync request
  - `status` string, required

## Other responses

- `400` — Bad request (invalid/missing syncType, invalid app)
- `401` — Unauthorized (missing/invalid Authorization header)
- `403` — Forbidden (no permission for app)
- `500` — Internal server error

---

[API](https://skmtc.net/gupshup/apis/partner-portal-public-apis.md) · [All operations](https://skmtc.net/gupshup/apis/partner-portal-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupshup/partner-portal-public-apis/revisions/1846573c8f87/schema)