Genesys Cloud
Deprecation of current External Contacts Merge Endpoint

発表日 発効日 Aha! アイデア
2025-07-21 2025-11-17 -

On the effective date, Genesys Cloud will deprecate the following components in the External Contacts API:

  • The current merge endpoint: POST /api/v2/externalcontacts/merge/contacts
  • The mergeOperation in the contact object.

Genesys Cloud will replace these endpoints with a new Merge Endpoint: POST /api/v2/externalcontacts/contacts/merge. The new Merge Endpoint enables developers and administrators to perform these tasks:

  • Merge up to 25 contacts (N-way merging), an increase over the previous ability to merge only two contacts.
  • Merged contacts can be of any type instead of restricting the merge operation to only certain types, such as ephemeral and identified.
  • Requests can contain a valueOverride to set fields in the resulting contact after merge.

よくある質問

影響を受けますか?

If you use the existing Merge Endpoint to merge contacts, you are affected by this deprecation.

削除日前に何をする必要がありますか?

Genesys recommends reviewing the new Merge Endpoint: POST /api/v2/externalcontacts/contacts/merge to take advantage of the enhanced features and future support.

どうすればこの廃止に備えることができますか?

Review your current integrations and begin transitioning to the new Merge API. Plan your migration to ensure continued functionality and access to the latest improvements.

助けが必要な場合や質問がある場合はどうすればよいですか。

Contact your Genesys account team. You can also visit My Support for additional assistance.