List

List all of the available apps.

Note: The name entry is used in all the other API calls to identify a app.

Parameter Required Requirements Description
task Yes Must be set to getavailable Retrieve Available Apps
user Yes Customer subuser must be registered under your account The customer subuser who we will update

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=getavailable&method=apps&user=example@example.com

Response

1
2
3
4
5
6
{
  "name": "twitter",
  "title": "Twitter",
  "description": "This plugin allows you to send an email message to twitter",
  "activated": false
}

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=getavailable&method=apps&user=example@example.com

Response

1
2
3
4
5
6
7
8
9
10
11
<?xml version="1.0" encoding="ISO-8859-1"?>

<filters>
   <filter>
      <name>twitter</name>
      <title>Twitter</title>
      <description>This plugin allows you to send an email message to twitter</description>
      <activated>0</activated>
   </filter>
   ...
</filters>

Activate App

Parameter Required Requirements Description
task Yes Must be set to activate Retrieve Available Apps
user Yes Customer subuser must be registered under your account The customer subuser who we will update

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=twitter&method=apps&task=activate&user=example@example.com

Response

1
2
3
{
  "message": "success"
}

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=twitter&method=apps&task=activate&user=example@example.com

Response

1
2
3
4
5
<?xml version="1.0" encoding="ISO-8859-1"?>

<result>
   <message>success</message>
</result>

Deactivate App

Parameter Required Requirements Description
task Yes Must be set to deactivate Retrieve Available Apps
user Yes Customer subuser must be registered under your account The customer subuser who we will update

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=twitter&method=apps&task=deactivate&user=example@example.com

Response

1
2
3
{
  "message": "success"
}

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=twitter&method=apps&task=deactivate&user=example@example.com

Response

1
2
3
4
5
<?xml version="1.0" encoding="ISO-8859-1"?>

<result>
   <message>success</message>
</result>

Customize App

These API calls require that settings are passed using POST.

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=twitter&method=apps&task=setup&user=example@example.com

Response

1
{"message":"success","settings":[{"field_name":"field_value"}]}

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=twitter&method=apps&task=setup&user=example@example.com

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<filter><field_name>field_value</field_name>
    ...
  </filter>

<!-- error -->
<?xml version="1.0" encoding="ISO-8859-1"?>

<result>
   <message>error</message>
   <errors>
      ...
      <error>... error messages ...</error>
      ...
   </errors>
</result>

Get Current Settings

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=twitter&task=getsettings&user=example@example.com&method=app

Response

1
2
3
4
5
6
7
8
9
{"message":"success","settings":[{"field_name":"field_value"}]}

//error
{
  "message": "error",
  "errors": [
    "...error messages..."
  ]
}

Call

POST https://api.sendgrid.com/apiv2/reseller.manageSubuser.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=twitter&task=getsettings&user=example@example.com&method=app

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<filter><field_name>field_value</field_name>
    ...
  </filter>

<!-- error -->
<?xml version="1.0" encoding="ISO-8859-1"?>

<result>
   <message>error</message>
   <errors>
      ...
      <error>... error messages ...</error>
      ...
   </errors>
</result>