<img src="https://d5nxst8fruw4z.cloudfront.net/atrk.gif?account=lYCzn1QolK10N8" style="display:none" height="1" width="1" alt="">

GreenArrow Engine Configuration API

This is the documentation for the GreenArrow Engine Configuration API. If you have additional questions about the API or feel that you’ve encountered a bug, please don’t hesitate to contact us at our support address.

Interactions with this API are accomplished over HTTP. On POST and PUT requests, JSON is expected as the body of the request. All API calls reply with JSON.


HTTP basic authentication is used. You should use a username and password that is authorized to log in to GreenArrow Engine’s web interface.

Return Values

All responses from the API will include the following keys.



Returns true if the requested operation was carried out successfully and false otherwise.



The data hash will contain whatever response is defined in the specific API endpoint that is being called.

If there is an error or if the endpoint returns no data, null is returned in this key.



If success is true, this value is set to null. On failed queries, this value is set to one of the predefined error codes.


array of strings

If success is true, this value is set to null. On failed queries, this value is set to an array of English strings that describe the failure(s).

Using curl

Throughout this section, we include non-application specific examples of API calls.

curl can be a useful debugging tool. The following example demonstrates how to create a new Throttling Template using curl:

cat << 'EOT' > /tmp/body.json
  "throttling_template": {
    "name": "Example Throttling template",
    "rules": [
        "domains": [
        "throttle_program": {
          "id": 1,
          "name": "this name doesn't exist"
        "max_concurrent_connections": 2,
        "max_messages_per_hour": 0
        "domains": [
        "throttle_program": {
          "name": "test 2"
        "max_concurrent_connections": 0,
        "max_messages_per_hour": 500
    "default": {
      "max_concurrent_connections": 1,
      "max_messages_per_hour": 60

curl --user username:password -H "Content-Type: application/json" -X POST --data @/tmp/body.json https://example.com/ga/api/v3/eng/throttling_templates

See the Throttling Templates page for more details on the specific parameters being passed in the above example.

Copyright © 2012–2019 GreenArrow Email