To automate lead capture from email via API (instead of creating contacts manually from email), you will need to send a specially-formatted email to your Relenta account. The following block of options and instructions needs to be present somewhere in the body of the email:
### BEGIN CREATE CONTACT ###
API_KEY:
EMAIL:
FULL_NAME:
FIRST_NAME:
LAST_NAME:
JOB_TITLE:
COMPANY:
CONTACT_COMMENTS:
PHONE(LABEL):
WEBSITE(LABEL):
MESSENGER(LABEL):
FAX(LABEL):
ADDRESS(LABEL):#START#
#END#
TEXT(LABEL):#START#
#END#
BLOCK NAME|PHONE(LABEL):
GROUPS: {comma-delimited list of group IDs}
OPTIONS: {overwrite/update/cancel}
MATCH_BY: {comma-delimited list of contact fields}
REMOVE_THIS_BLOCK: {yes/not}
### END CREATE CONTACT ###
Notes:
- The API_KEY can be found under My account > API tab. It is optional unless OPTIONS is set to "overwrite" or "update"
- Either FULL_NAME or FIRST_NAME and LAST_NAME should be used, but not both. The FULL_NAME string will be split into first and last names.
- (LABEL) value is optional
- #START# and #END# markers are required only for multi-line values (such as address or text field)
- Group IDs can be found in Contacts > Categories and groups > Edit category > Show group IDs
- If REMOVE_THIS_BLOCK is set to Yes, all text between and including ### BEGIN CREATE CONTACT ### and ### END CREATE CONTACT ### will be removed from email body.
- The option to {Overwrite/Update/Cancel} pertains to the situations when contact with a given email already exists in the department database.
- The following fields can be used in MATCH_BY: contact_id, email, first_name, last_name, job_title, company. If the fields listed in MATCH_BY match an existing contact, it will be updated. Otherwise, a new contact will be created. If MATCH_BY fields aren't specified, the default match by email only will be used.
Example:
### BEGIN CREATE CONTACT ### API_KEY: c394dr5723te9f874qbb923dl8345 EMAIL: james.bond@mi6.gov.uk FULL_NAME: James Bond JOB_TITLE: Agent COMPANY: Secret Intelligence Service CONTACT_COMMENTS: Licensed to kill PHONE(work): +44 347928374289 WEBSITE(work): www.mi6.gov.uk MESSENGER(Skype): jamesbond FAX: +44 384573957345 ADDRESS:#START# PO Box 1300 London SE1 1BD United Kingdom #END# TEXT(customer comments):#START# That's pretty potent. Not the cork. Your after-shave. Strong enough to bury anything. But the wine is quite excellent. Although for such a grand meal, I would have expected a claret. #END# Billing info|PHONE(billing): +44 90281465543 GROUPS: 12538044 OPTIONS: update MATCH_BY: email, first_name, last_name REMOVE_THIS_BLOCK: No ### END CREATE CONTACT ###