API reference
Help CenterCommunityDevelopersAcademyStatus

Add a contact to a program - AddContactToProgram

Adds a contact to the beginning of an Acoustic Campaign program.

Typically, you use this call with either AddRecipient or UpdateRecipient. After you add or update a contact with those calls, the Recipient ID in the response XML can be used in the CONTACT_ID element in this AddContactToProgram request.

🚧

The contact is not added if any of the following scenarios exist:

  • The specified CONTACT_ID is already an active participant in the Program.
  • The specified CONTACT_ID is NOT in the database that is associated with the Program.
  • The specified PROGRAM_ID is Pending and not accepting new Contacts.
  • The specified PROGRAM_ID is Inactive and not accepting new Contacts.
  • The specified PROGRAM_ID is Completed and not accepting new Contacts.
  • The specified PROGRAM_ID has a Last Contact Add Date in the past.
  • The specified PROGRAM_ID does not exist.

Elements (Required)

PROGRAM_ID - The unique ID of the program you want to add a contact.

CONTACT_ID - The unique ID of the contact to add to the program.

<Envelope>
  <Body>
    <AddContactToProgram>
      <PROGRAM_ID>56753246</PROGRAM_ID>
      <CONTACT_ID>7657657</CONTACT_ID>
    </AddContactToProgram>
  </Body>
</Envelope>

<Envelope>
  <Body>
    <RESULT>
      <SUCCESS>TRUE</SUCCESS>
    </RESULT>
  </Body>
</Envelope>

Elements (Results)

SUCCESS - True if successful, False if not.