How to start - examples

Prerequisite

  • This examples will use basic curl commands
  • I will ommit most of repeative parts of curl commands (only explain them once)
  • Examples are designed for SMB users not Getresponse360

Curl

curl -H “X-Auth-Token: api-key 5377d45b66c6dd2540c3887e957fe999” https://api.getresponse.com/v3/accounts
  • -H is a flag that allows to send Header with request. I use it to send my api-key. It is mandatory header for EVERY request.
  • Second parameter is a request URL.
  • For post request you must use flag -d with content of a post body after that.
  • For delete request you must use -X DELETE flag.
  • In next examples i will omit -H “X-Auth-Token” header

Basic actions

Update you account information

I want to update my profile info. First let me see how this profile resource looks like…

curl https://api.getresponse.com/v3/accounts

Response


{
    "accountId": "aJYH",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@example.com",
    "phone": "+485835148754",
    "companyName": "LoveMyHardware",
    "state": "Pomorskie",
    "city": "Gdansk",
    "zipCode": "80-300",
    "countryCode": {
        "countryCodeId": "175"
    },
    "industryTag": {
        "industryTagId": null
    },
    "numberOfEmployees": "500",
    "timeFormat": "24h",
    "href": "http://api.getresponse.com/v3/account/aJYH"
}

Hmm, it looks ok, but i want to change my phone

Update postal information

curl https://api.getresponse.com/v3/accounts -d "
    {
        "phone": "+485865430923",
    }
"

Ok, thats done, now i need to add some nice from-fields for my emails.

Add from-fields

First I want to look at existing from-fields.

curl https://api.getresponse.com/v3/from-fields

Response

[
    {
        "fromFieldId": "ufIK",
        "email": "john.smith@example.com",
        "name": "John Smith",
        "isActive": "true",
        "isDefault": "true",
        "createdOn": "2014-06-16T09:07:09+0000",
        "activatedOn": null,
        "href": "http://api.getresponse.com/v3/from-fields/ufIK"
    }
]

Ok, I want to sends email to my future subscribers using the same email address but different “name” to appear in “from” field :). I decided to create two, one for PC users and one for Mac’s.

Mac

curl http://api.getresponse.com/v3/from-fields -d "

        {
            "email": "john.smith@example.com",
            "name": "John "ILoveMac" Smith"
        }

PC

curl http://api.getresponse.com/v3/from-fields -d "

        {
            "email": "john.smith@example.com",
            "name": "John "ILovePC" Smith"
        }

I’ve created my new from-fields waited for confirmation emails and when the arrive, I’ve confirmed them and now they are active.

Add custom-fields

Ok, now it’s time for some custom fields. I want to “categorize” my subscribers based on some property I’ve define. I have some ideas what to do with them later…

ComputerType

curl http://api.getresponse.com/v3/custom-fields -d "
    {
        "name": "OperatingSystem",
        "type": "radio",
        "hidden": "false",
        "values": [
            "Win",
            "OsX",
            "Linux"
        ]
    }
"

OperatingSystem

curl http://api.getresponse.com/v3/custom-fields -d "
    {
        "name": "OperatingSystem",
        "type": "radio",
        "hidden": "false",
        "values": [
            "Win",
            "OsX",
            "Linux"
        ]
    }
"

VipStatus

Last but not least I want to set certain subscribers as a “VIP”. This will be manual process, and i don’t want to subscribers changes this custom-field. This should be hidden.

curl http://api.getresponse.com/v3/custom-fields -d "
    {
        "name": "VipStatus",
        "type": "radio",
        "hidden": "true",
        "values": [
            "Yes",
            "No"
        ]
    }
"

Now my custom-field list looks like that:

[
    {
        "customFieldId": "JK",
        "href": "http://api.getresponse.new/v3/custom-fields/JK",
        "name": "ComputerType",
        "type": "radio",
        "hidden": "false",
        "values": [
            "Mac",
            "PC"
        ]
    },
    {
        "customFieldId": "eN",
        "href": "http://api.getresponse.new/v3/custom-fields/eN",
        "name": "OperatingSystem",
        "type": "radio",
        "hidden": "false",
        "values": [
            "Linux",
            "OsX",
            "Win"
        ]
    },
    {
        "customFieldId": "SP",
        "href": "http://api.getresponse.new/v3/custom-fields/SP",
        "name": "VipStatus",
        "type": "radio",
        "hidden": "true",
        "values": [
            "No",
            "Yes"
        ]
    }
]