Document toolboxDocument toolbox

Working with sending policies using the API

Owned by Juan Tomás Alonso Nieto (Deactivated)
Last updated: Nov 07, 2024 by Borja Moro Moreno
6 min read
[ 1 Overview ] [ 2 Endpoints and methods ]

Overview

Check the list of available endpoints and methods to work with sending policies using the Delivery methods API:

Endpoints and methods

Description

GET /policies see below

Lists the available sending policies in the domain.

GET /policy/{id} see below

Gets a detailed description of a specific sending policy.

POST /policies see below

Creates a new sending policy.

PUT /policies see below

Edits a sending policy.

DELETE /policies/{id} see below

Deletes a sending policy.

Endpoints and methods

GET /policies

Retrieves a list of the sending policies in the domain.

Example

Find below a request example in cURL language. This request will retrieve all the email type delivery methods in the domain that corresponds to the given token. Learn how to authorize your request in this article.

curl -H "standAloneToken:YOUR_TOKEN" -X GET "https://api-us.devo.com/delco/policies"

Check the list of available responses:

Code

Description

Code

Description

200

Successful response. Available sending policies retrieved.

[ { "id": 284, "name": "default-delivery", "isDefault": true, "scheduled": { "days": [ "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "from": "00:00", "to": "23:59" }, "deliveryMethods": [ { "id": 331, "type": "email", "name": "default-email" } ], "antiFloodingPolicy": { "id": 267, "name": "default AF" } }, { "id": 1275, "name": "mySendingPolicy", "isDefault": false, "scheduled": { "days": [ "TUESDAY", "THURSDAY" ], "from": "09:30", "to": "18:30" }, "deliveryMethods": [ { "id": 331, "type": "email", "name": "default-email" } ], "antiFloodingPolicy": { "id": 267, "name": "default AF" } }, { "id": 467, "name": "Workweek - Support Hours", "isDefault": false, "scheduled": { "days": [ "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY" ], "from": "08:00", "to": "20:00" }, "deliveryMethods": [ { "id": 331, "type": "email", "name": "default-email" } ], "antiFloodingPolicy": null } ]

400

Request error.

{ "code": 400, "msg": "string", "cid": "string" }

403

Authentication required.

GET /policy/{id}

Gets a detailed description of a specific sending policy given its ID.

Path parameters

Add the following path parameters as part of the endpoint:

Parameter

Type

Definition

Parameter

Type

Definition

id required

integer

ID of the sending policy you want to retrieve.

How can I get the ID of a sending policy

You can use the GET /policies endpoint to get the IDs of the sending policies defined in your domain.

Example

Find below a request example in cURL language. This request will retrieve all the email type delivery methods in the domain that corresponds to the given token. Learn how to authorize your request in this article.

Check the list of available responses:

Code

Description

Code

Description

200

Successful response. Details of the sending policy retrieved.

400

Request error.

403

Authentication required.

POST /policies

Creates a new sending policy.

Request body

You must specify the updates you need to apply to the delivery method in the request body:

Parameter

Type

Definition

Parameter

Type

Definition

name required

string

Name of the new sending policy.

deliveryMethods required

object

Recipient of the alert, which corresponds to a delivery method created in the domain.

Define an object with the following parameters:

  • id (integer) - The ID of the desired delivery method. You can use the GET /methods endpoint to check the ID (more details here).

Example

Visit Create and manage delivery methods to know more.

isDefault

boolean

If you set this to true, this policy will be automatically assigned to new alerts and predefined alerts that have not actively been assigned a sending policy.

antiFloodingPolicy

 

Frequency limit established for persistent alerts. You can choose between none, default, or one of your own creation.

Visit Create and manage delivery methods to know more.

scheduled

object

Days and hours during which alerts should be distributed. The time zone defined in the delivery method(s) selected is used to calculate times.

Define an object with the following parameters:

  • days (string) - Enter the weekdays you want the alert to be distributed. Indicate the specific days between brackets []. For example:

  • from - Indicate the starting time for alerts to be sent.

  • to -

Example

Request example

PUT/policies

Edits an existing sending policy.

DELETE /policies/{id}

Deletes a sending policy.