Contacts

This resource allows a user to sign up as a contact for the fanclub.

POST /contacts

Add the user to the fanclub's contacts

Request

* Note: Any other attributes passed to the contact parameter will be saved internally as part of the Contact's custom_fields

Name Type Description
contact[email] string [Required] The email address of the user
contact[first_name] string [Optional] The first name of the user
contact[last_name] string [Optional] The last name of the user
contact[birthdate] string [Optional] The birthdate of the user (example: "1980-01-01")
contact[lists_opt_in_source] string [Optional] The source of this contact (example: "Giveaway Campaign")

Responses

Success: After POST request to /contacts*

{
    "status": "ok",
    "messages": [
        "Please check your email for confirmation instructions"
    ]
}
Failure: Missing contact parameter
{
    "status": "error",
    "messages": [
        "Contact parameter is required."
    ]
}

Failure: Already subscribed (as active customer)

{
    "status": "error",
    "messages": ["Email is already subscribed as a member of <fanclub name>"]
}

Failure: Already subscribed (as contact)

{
    "status": "error",
    "messages": ["You are already subscribed"]
}

Failure: Invalid email

{
    "status": "error",
    "messages": ["Email does not appear to be valid"]
}

Failure: Invalid birthdate

{
    "status": "error",
    "messages": ["Must enter a valid birthdate"]
}

Failure: Wrong age

{
    "status": "error",
    "messages": ["You are not old enough"]
}