Removal of XM Directory API Endpoints

What is the change?

Several XM Directory Public API endpoints will be fully removed by June 30, 2026. After that date, any calls to these endpoints will return a 404 response.

The following endpoint groups are being removed:

Research Core Contacts API

All legacy Research Core Contacts API endpoints are being removed. See the Research Core to XM Directory Migration Guide for the full list and their XM Directory replacements.

Contact Frequency Rules

• Get Contact Frequency Rule
• Create Contact Frequency Rule
• Update Contact Frequency Rule
• Delete Contact Frequency Rule

Samples

• Get Sample Definition
• Create Sample Definition
• Update Sample Definition
• Delete Sample Definition
• Update Sample

Segment Memberships

• Create Export Contact Segment Memberships
• Get Contact Segment Memberships Export Progress
• Get Contact Segment Memberships Export File

Transactions

• Get Transaction Contacts Import Summary

What action do I need to take?

Research Core Contacts API — Action required

Migrate to the equivalent XM Directory endpoints before June 30, 2026. The Research Core to XM Directory Migration Guide walks through each replacement endpoint.

Get Transaction Contacts Import Summary — Action required

Replace calls with Get Transaction Contacts Import Status, which returns equivalent information.

Contact Frequency Rules, Samples, and Segment Memberships — No action required

These endpoints are being removed with no replacements. If your workflows call any of these endpoints, remove those calls before June 30, 2026.

What if I have questions?

If you have a question about this change, please visit the Public API documentation site. It's also always worth checking the Experience Community to see if any other users have the same question.

If you'd rather speak to a specialist, our Support Team is always ready to assist. To contact them, file a support request from your Customer Success Hub.