mautic / mautic/developer-documentation-new

[DOCS]: "contactIds" should be replaced with "ids"

Open
#555 5 comments 0 reactions 1 assignee View on GitHub

@hellpe is already working on this.

Since Jul 2, 2026.

documentation
Dominant language
Shell
Stars
19
Forks
48
Avg merge
1d 16h
Merged PRs (30d)
25

Description

Description

Documentation for adding multiple contacts to a segment states the following:

Name Type Description
contactIds array Required. Array of Contact IDs to add to the Segment

However, sending a request with contactIds as a parameter returns a 400 error. I discovered that sending ids instead of contactsIds works (tested on n8n as shown in the attached screenshot):

Image
Relevant Documentation URL

https://devdocs.mautic.org/en/7.0/rest_api/segments.html#add-contacts-to-segment

Are you willing to help us fix this by making a pull request?

Yes, but I need help

Suggestions (Optional)

I'd suggest to replace contactIds with ids, but I'm not sure if this is the intended behavior

Screenshots or Screen Recordings (Optional)

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.