Create Search Synonym

Creates a search-synonym group — the Create Synonym action on the admin Marketing → Search & SEO → Search Synonyms screen.

TIP

New here? Read the Search Synonyms overview for what a search synonym is and how its fields behave.

Endpoint

Endpoint	Method
/api/admin/marketing/search-synonyms	POST

Details

• Requires an admin Bearer token and the marketing.search_seo.search_synonyms.create permission.
• Returns the full synonym payload.

Request body

Field	Type	Required	Notes
name	string	yes	Group name
terms	string	yes	Comma-separated list of interchangeable search words (e.g. shirt,tshirt,tee)