Documenting "withContactCounts" for campaign API by escopecz · Pull Request #293 · mautic/developer-documentation-new

escopecz · 2026-02-17T09:42:29Z

Docs for mautic/mautic#15878. This should be rebased to the 7.1 branch once it exists.

adiati98

Thanks for the PR, @escopecz! I have some suggestions to address here. TIA! ✨

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

escopecz · 2026-02-18T09:15:17Z

@adiati98 thanks for the suggestions! Applied

The base branch was changed.

adiati98

Hi @escopecz,

There's some minor tweak here, and I have a question. TIA! ✨

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Copilot

Pull request overview

Adds REST API documentation for the withContactCounts query parameter on Campaign endpoints, describing the returned contact-count fields and the caching behavior/TTL configuration.

Changes:

Documented contactCount and contactCountFetchedAt Campaign properties (gated behind withContactCounts=true).
Added withContactCounts to the List Campaigns query parameters and clarified cache TTL behavior in a note.
Allowed the acronym “TTL” in Vale’s accepted vocabulary.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
docs/rest_api/campaigns.rst	Documents `withContactCounts` behavior, additional response fields, and caching/TTL configuration notes.
.github/styles/config/vocabularies/Mautic/accept.txt	Adds “TTL” to the Vale accept list to prevent linting false-positives.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

adiati98

@escopecz a couple of small suggestions here. Also, can you please check the suggestions by copilot and confirm if they're correct? TIA! ✨

Copilot

Copilot was unable to review this pull request because the user who requested the review is ineligible. To be eligible to request a review, you need a paid Copilot license, or your organization must enable Copilot code review.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

Copilot

Copilot was unable to review this pull request because the user who requested the review is ineligible. To be eligible to request a review, you need a paid Copilot license, or your organization must enable Copilot code review.

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

adiati98

Thanks so much, @escopecz! 🚀

Documenting "withContactCounts" for campaign API

2cbb1f7

escopecz requested a review from a team as a code owner February 17, 2026 09:42

escopecz requested review from adiati98 and favour-chibueze and removed request for a team February 17, 2026 09:42

escopecz mentioned this pull request Feb 17, 2026

Add Contact count to Campaigns API object (#2884) mautic/mautic#15878

Merged

adiati98 requested changes Feb 18, 2026

View reviewed changes

Comment thread docs/rest_api/campaigns.rst Outdated

Comment thread docs/rest_api/campaigns.rst Outdated

Comment thread docs/rest_api/campaigns.rst Outdated

Comment thread docs/rest_api/campaigns.rst

adiati98 added the needs-rebase label Feb 18, 2026

Apply suggestions from code review

a46e7b5

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

adiati98 and others added 2 commits February 18, 2026 10:51

add TTL to accept.txt and remove excess period

4c3004b

Merge branch '5.x' into MAUT_13385

c40d7c3

adiati98 mentioned this pull request Mar 4, 2026

docs: Document withContactCounts parameter for Campaigns API #298

Closed

adiati98 added 3 commits March 4, 2026 18:16

Merge branch '5.x' into MAUT_13385

c3e09a6

Merge branch '5.x' into MAUT_13385

2458a9b

Merge branch '5.x' into MAUT_13385

6e7abdb

adiati98 previously approved these changes Mar 8, 2026

View reviewed changes

adiati98 added this to the 7.1 milestone Mar 9, 2026

Merge branch '5.x' into MAUT_13385

d39dc2d

adiati98 changed the base branch from 5.x to 7.1 March 25, 2026 07:16

adiati98 requested review from a team and adiati98 March 25, 2026 07:16

adiati98 removed the needs-rebase label Mar 25, 2026

Merge branch '7.1' into MAUT_13385

62c5ae2

adiati98 requested changes Mar 25, 2026

View reviewed changes

Comment thread docs/rest_api/campaigns.rst

Comment thread docs/rest_api/campaigns.rst Outdated

Comment thread docs/rest_api/campaigns.rst

Capital C

b154c3d

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

escopecz requested review from adiati98 and Copilot March 25, 2026 08:45

Copilot started reviewing on behalf of escopecz March 25, 2026 08:45 View session

Copilot AI reviewed Mar 25, 2026

View reviewed changes

Comment thread docs/rest_api/campaigns.rst Outdated

Comment thread docs/rest_api/campaigns.rst Outdated

Update docs/rest_api/campaigns.rst

9dfe3e7

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 25, 2026 09:55

Copilot started reviewing on behalf of escopecz March 25, 2026 09:56 View session

Copilot AI reviewed Mar 25, 2026

View reviewed changes

Comment thread docs/rest_api/campaigns.rst

adiati98 requested a review from RCheesley April 2, 2026 20:05

Merge branch '7.1' into MAUT_13385

96d6268

adiati98 requested changes May 13, 2026

View reviewed changes

Comment thread docs/rest_api/campaigns.rst Outdated

Comment thread docs/rest_api/campaigns.rst Outdated

Merge branch '7.1' into MAUT_13385

a5a829c

Copilot AI review requested due to automatic review settings May 13, 2026 19:24

Copilot AI reviewed May 13, 2026

View reviewed changes

Apply suggestions from code review

96ff550

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Copilot AI review requested due to automatic review settings May 14, 2026 07:55

Copilot started reviewing on behalf of escopecz May 14, 2026 07:56 View session

Copilot AI reviewed May 14, 2026

View reviewed changes

escopecz requested a review from adiati98 May 14, 2026 07:56

adiati98 reviewed May 15, 2026

View reviewed changes

Comment thread docs/rest_api/campaigns.rst

fix: add a blank line after vale off statement

728dd0f

Copilot AI review requested due to automatic review settings May 15, 2026 08:26

Copilot AI reviewed May 15, 2026

View reviewed changes

escopecz requested a review from Copilot May 15, 2026 08:42

Copilot started reviewing on behalf of escopecz May 15, 2026 08:42 View session

Copilot AI reviewed May 15, 2026

View reviewed changes

adiati98 approved these changes May 15, 2026

View reviewed changes

adiati98 merged commit c05f967 into mautic:7.1 May 15, 2026
7 checks passed

Conversation

escopecz commented Feb 17, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

escopecz commented Feb 18, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants