# Push people into CRM contacts

## Purpose
Keep a working list of the people around your campaigns (leads, applicants, and the
participants you want to follow up with) and move people between the two.

## Who this is for
Account Managers and Contact Managers, and anyone else whose role lets them see and change
contacts. A Campaign Manager on their own cannot open Contacts.

## How the two lists relate

Participants and contacts are different things and the flow between them runs both ways:

- **Participants → contacts.** The campaign participant list is the spine. You push one,
  some, or all of a campaign's participants into the contact list. This is the usual
  direction.
- **Contacts → participants.** A qualified contact can be converted into a participant
  in a named campaign.

Contacts also arrive on their own, from public contact forms and registrations, or you
add them by hand.

## Push participants into contacts

1. Open the campaign and go to the **Participants & Roles** tab.
2. Either:
   - tick the participants you want and choose **Add to CRM (n)**; or
   - tick nothing and choose **Add all to CRM**, which asks you to confirm before syncing
     every participant in the campaign.
3. A summary reports how many contacts were created, how many existing contacts were
   updated, and how many were skipped.

Participants without an email address are skipped: email is the identity a contact is
keyed on. Running the sync again is safe: an existing contact is not duplicated. It only gains details
it was missing, and an archived contact is brought back into the list.

## Work with the contact list

Sidebar **Contacts**. The left pane is the list, the right pane the selected contact.

Filter with the search box (name, email, company), the stage dropdown, and a **Show
archived** checkbox. Contacts move through five stages: **new → contacted → qualified →
converted → lost**.

**New** opens an inline form: email is required, first name, last name and company are
optional.

## Work on one contact

Selecting a contact gives you:

- **Stage**: change it from the dropdown; the change is saved immediately and recorded
  on the timeline.
- **Language** (the language you write to this person in): **Not stated**, **English**,
  **Français**, **Português (Brasil)** or **Español**. Saved as soon as you choose.
  **Not stated is not the same as English**: somebody who has stated nothing is written
  to in English plus your account's primary language, and choosing *Not stated* again
  clears the field and puts them back on that rule. A contact pushed in from a campaign
  roster arrives with whatever the participant stated, and a language you set here is
  never overwritten by a later sync.
- **Owner**: assign a person by user id, then **Save**. There is no member picker; the
  field's own hint says so, and you paste the id.
- **Tags**: comma-separated, then **Save**.
- **Convert to participant**: choose the campaign from the dropdown and choose
  **Convert**. Disabled on archived contacts, and when the account has no campaigns.
- **Works at**: the organisations this person works at and their role there, each opening
  its entry on the track. Shown only when there are any.
- **Archive**: hides the contact from the default list without deleting it.
- **Activity**: a timeline of notes, stage changes and system events. Type in **Add a
  note** and press Enter or **Add**.

## What happens next
- A converted contact appears in that campaign's participant list, and can then be
  invited or sent an assessment link like any other participant.
- Contacts are readable by integrations through a read-only API scope, so an external
  CRM can mirror this list, the **Language** field included. The read-only scope
  cannot change contacts.
- An integration of your own can set the language without the screen:
  `PATCH /api/v1/accounts/{accountId}/crm/contacts/{contactId}` takes `language`, and
  sending `null` clears it.

## Limits and gotchas
- The owner is entered as a raw user id. Expect to copy and paste that one.
- Archiving is the closest thing to deletion offered in the interface.
- Pushing participants to CRM copies their details at that moment. Syncing again only
  fills details the contact is missing; it never overwrites a name, company or language
  the contact already has, so change those on the contact itself.
- Pushing participants into contacts, and converting a contact, each need two permissions:
  one to change contacts and one on the campaign (to read its participants for a push, to
  add participants for a convert). No single built-in role has both, so give the person
  Account Manager or Contact Manager together with Campaign Manager. Otherwise the button
  shows but the request is refused.

## Related pages
- [Add people to a campaign](/operate/tenant-admin/add-people-to-a-campaign)
- [What language your emails go out in](/operate/tenant-admin/transactional-email-language)
- [Run registration intake](/operate/tenant-admin/registration-intake)
