API Signup Forms

Updated on: June 3, 2015 Category: API

Signup Forms API Calls

There are currently two REST methods to get a list of your data fields and other associated sign up details.

API Endpoint

https://api.robly.com/

Note
As with all API methods, the api_key and api_id parameters are required for all methods.


API Actions:

  • View Data Fields (show)
  • Subscribe a New Contact (generate)

View Data Fields and Sub Lists for Signup Form

This API call will display the data fields and sub lists that you can use when generating a new subscribed contact. By default the API call will return only those fields that are publicly accessible, if you want to view all possible fields pass in the optional param ‘include_all=true’.

/api/v1/sign_up/show?api_key=api_key&api_id=api_id [GET]

Optional Params: include_all [true, false]

example
Example API call (GET)
https://api.robly.com/api/v1/sign_up/show?api_id=8ec55ecb23a8facac6280e84be513fee&api_key=eb81bd1f0ad28b0a

JSON Output:{"fields":[{"field":{"id":406,"label":"Last Name","tag_type":"Textfield","is_required":false,"position":2,"created_at":"2013-07-27T03:29:38Z","updated_at":"2013-11-06T18:31:28Z","default_tag":"data2","user_tag":"lname"}},{"field":{"id":404,"label":"Email Address","tag_type":"Emailfield","is_required":true,"position":0,"created_at":"2013-07-27T03:29:38Z","updated_at":"2013-07-27T03:29:38Z","default_tag":"data0","user_tag":"email"}},{"field":{"id":405,"label":"First Name","tag_type":"Textfield","is_required":false,"position":1,"created_at":"2013-07-27T03:29:38Z","updated_at":"2014-02-24T22:32:30Z","default_tag":"data1","user_tag":"fname"}}],"sub_lists":[{"sub_list":{"id":17269,"name":"List B","position":2,"created_at":"2014-06-26T18:42:33Z","updated_at":"2014-07-08T03:20:34Z"}},{"sub_list":{"id":17276,"name":"List C","position":3,"created_at":"2014-06-26T18:42:33Z","updated_at":"2014-06-26T22:16:08Z"}},{"sub_list":{"id":17277,"name":"List D","position":4,"created_at":"2014-06-26T18:42:33Z","updated_at":"2014-06-26T22:16:09Z"}}]}

Subscribe a New Contact

Using the data fields and sub lists submitted the new contact will be subscribed to your newsletters. You could recreate our signup widget using this API call if you wanted to, but it is typically used for close integration with CRMs.

/api/v1/sign_up/generate?api_key=api_key&api_id=api_id [POST]
example
Example - email & first name (POST)
https://api.robly.com/api/v1/sign_up/generate?api_id=8ec55ecb23a8facac6280e84be513fee&api_key=eb81bd1f0ad28b0a&email=new_contact@newemail.com&fname=Mike

JSON Output:{"successful":true,"message":"Contact added"}
example – email, last name & 2 sub lists
Note that when submitting multiple values for the same parameter (eg. sub_lists) in this case, you must pass the parameter as an array (sub_lists[]). If you pass the parameter as just sub_lists twice (without using the []) only one sub list will be assigned to the contact.

/api/v1/sign_up/generate?api_id=8ec55ecb23a8facac6280e84be513fee&api_key=eb81bd1f0ad28b0a&email=mike@newemail.com&lname=Smith&sub_lists[]=17277&sub_lists[]=17276

JSON Output:{"successful":true,"message":"Contact added"}

Optional Parameters:
We have three optional parameters. 

Parameter: double_opt_in=true
The first is for a full double opt-in process to occur. With this parameter the contact will be sent a confirmation email which must be clicked before they are added as a subscribed contact. They will then receive the welcome email. 

Parameter: welcome_email=true
The second optional parameter is to skip the confirmation email and just send the welcome email. 

Parameter: include_autoresponder=true
This optional param will trigger any autoresponders that match the criteria for this newly subscribed contact.

You can also contact us here

  • Live Chat Support

    Live chat is open
    between 9am-7pm EST.

  • Email Support

    During business hours,
    we usually answer emails within minutes.

  • FAQ's

    Check out our FAQ
    for our most common issues.

'