Manage Pardot list memberships via the Account Engagement v5 API

In-depth guide

Steps

1. Obtain a Salesforce access token and Pardot Business Unit ID as described in the Pardot auth pattern.
2. To retrieve all lists: GET https://pi.pardot.com/api/v5/objects/lists with required headers; note the list IDs for the lists you need to manage.
3. To add a prospect to a list, POST https://pi.pardot.com/api/v5/objects/list-memberships with a JSON body containing 'listId' and 'prospectId'.
4. To remove a prospect from a list, DELETE https://pi.pardot.com/api/v5/objects/list-memberships/{listMembershipId}.
5. To look up an existing membership before creating one, GET https://pi.pardot.com/api/v5/objects/list-memberships?listId={id}&prospectId={id}.
6. Batch membership changes using separate API calls per membership — v5 does not provide a bulk list-membership endpoint; plan for rate limit backoff on large lists.