Apps

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 must be registered under your account The customer who we will update
method Yes Must be set to apps Allows you to access apps functionality

Call

1

https://sendgrid.com/apiv2/reseller.manage.xml?api_user=username&api_key=secureSecret&task=getavailable&method=apps&user=customer@example.com

Response: Success

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>

Call

1

https://sendgrid.com/apiv2/reseller.manage.json?api_user=username&api_key=secureSecret&task=getavailable&method=apps&user=customer@example.com

Response: Success

1
2
3
4
5
6

{
  "name": "twitter",
  "title": "Twitter",
  "description": "This plugin allows you to send an email message to twitter",
  "activated": "false"
}

Activate App

Parameter Required Requirements Description
task Yes Must be set to activate Retrieve Available Apps
user Yes Customer must be registered under your account The customer who we will update
method Yes Must be set to apps Allows you to access apps functionality

Call

1

https://sendgrid.com/apiv2/reseller.manage.xml?api_user=username&api_key=secureSecret&name=twitter&method=apps&task=activate&user=customer@example.com

Response: Success

1
2
3
4
5

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

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

Call

1

https://sendgrid.com/apiv2/reseller.manage.json?api_user=username&api_key=secureSecret&name=twitter&method=apps&task=activate&user=customer@example.com

Response

1
2
3

{
  "message": "success"
}

Deactivate App

Parameter Required Requirements Description
task Yes Must be set to deactivate Retrieve Available Apps
user Yes Customer must be registered under your account The customer who we will update
method Yes Must be set to apps Allows you to access apps functionality

Call

1

https://sendgrid.com/apiv2/reseller.manage.xml?api_user=username&api_key=secureSecret&name=twitter&method=apps&task=deactivate&user=customer@example.com

Response: Success

1
2
3
4
5

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

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

Call

1

https://sendgrid.com/apiv2/reseller.manage.json?api_user=username&api_key=secureSecret&name=twitter&method=apps&task=deactivate&user=customer@example.com

Response

1
2
3

{
  "message": "success"
}

Customize App

These API calls require that settings are passed using POST.

Call

1

https://sendgrid.com/apiv2/reseller.manage.xml?api_user=username&api_key=secureSecret&name=twitter&method=apps&task=setup&user=customer@example.com

Response: Success

1
2
3
4
5
6

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

<filter>
   <field_name>field_value</field_name>
   ...
</filter>

Response: Error

1
2
3
4
5
6
7
8
9
10

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

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

Return - Empty

This is returned if that filter has no settings or is not enabled.

1
2
3

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

<filter/>

Call

1

https://sendgrid.com/apiv2/reseller.manage.json?api_user=username&api_key=secureSecret&name=twitter&method=apps&task=setup&user=customer@example.com

Response: Success

1

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

Return - Empty

This is returned if that filter has no settings or is not enabled.

1
2
3

{
  "settings": null
}

Get Current Settings

Call

1

https://sendgrid.com/apiv2/reseller.manage.xml?api_user=username&api_key=secureSecret&name=twitter&task=getsettings&user=customer@example.com&method=app

Response: Success

1
2
3
4
5
6

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

<filter>
   <field_name>field_value</field_name>
   ...
</filter>

Response: Error

1
2
3
4
5
6
7
8
9
10

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

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

Return - Empty

This is returned if that filter has no settings or is not enabled.

1

<filter></filter>

Call

1

https://sendgrid.com/apiv2/reseller.manage.json?api_user=username&api_key=secureSecret&name=twitter&task=getsettings&user=customer@example.com&method=app

Response: Success

1

"message":"success","settings":{"field_name":"field_value"}

Response: Error

1
2
3
4
5
6

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

Return - Empty

This is returned if that filter has no settings or is not enabled.

1

"settings":null