List event triggers

Authorizations

SessionCookie

Parameters

Path Parameters

projectId

required

string

Tenant project id (row-level isolation on every query).

Responses

200

Triggers.

application/json

object

triggers

Array<object>

object

string

name

string

eventName

string

match

Trigger match rule. properties (event props), conditionTree (2-level any/all fact rules), userFilter (segment).

object

properties

object

key

additional properties

any

conditionTree

object | null

userFilter

Segment predicate shared by campaigns and trigger userFilter (all fields optional).

object

locale

One of:

string
Array<string>

string

hasEmail

boolean

hasPhone

boolean

userIdLike

string

firstSeenFrom

string format: date-time

firstSeenTo

string format: date-time

lastSeenFrom

string format: date-time

lastSeenTo

string format: date-time

savedAudienceId

string

queueKey

string

Allowed values: new_paid_activation key_created_low_usage high_balance_inactive high_value low_balance_renewal churn_risk_paid

paidStatus

One of:

string
Array<string>

string

valueTier

One of:

string
Array<string>

string

minLtv

number

maxLtv

number

minBalance

number

maxBalance

number

minUsage30d

number

maxUsage30d

number

lastPurchaseFrom

string format: date-time

lastPurchaseTo

string format: date-time

lifecycleStage

One of:

string
Array<string>

string

recommendedAction

One of:

string
Array<string>

string

templateId

string

providerId

string | null

identityId

string | null

category

string

Allowed values: transactional marketing

enabled

boolean

guardrails

object

maxSendsPerWindow

integer | null

windowSeconds

integer

quietHoursStartHour

integer | null

quietHoursEndHour

integer | null

quietHoursMode

string

Allowed values: defer drop

dedupeWindowSeconds

integer

dynamicAttachments

Array<object>

object

fromProperty

required

Event property holding the attachment URL.

string

>= 1 characters <= 120 characters

filename

string

>= 1 characters <= 200 characters

createdAt

string | null format: date-time

updatedAt

string | null format: date-time

401

Not authenticated (no valid session/principal).

application/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

1
{
2
  "error": "example",
3
  "message": "example"
4
}

403

Authenticated but lacks the required project role.

application/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

1
{
2
  "error": "example",
3
  "message": "example"
4
}

GET

/api/projects/{projectId}/email/triggers

1
curl --request GET \
2
  --url https://retidal.com/api/projects/%3Cstring%3E/email/triggers \
3
  --cookie trackly_session=%3CYOUR_API_KEY%3E

1
const url = 'https://retidal.com/api/projects/%3Cstring%3E/email/triggers';
2
const options = {method: 'GET', headers: {cookie: 'trackly_session=%3CYOUR_API_KEY%3E'}};
3

4
try {
5
  const response = await fetch(url, options);
6
  const data = await response.json();
7
  console.log(data);
8
} catch (error) {
9
  console.error(error);
10
}

1
import requests
2

3
url = "https://retidal.com/api/projects/%3Cstring%3E/email/triggers"
4

5
headers = {"cookie": "trackly_session=%3CYOUR_API_KEY%3E"}
6

7
response = requests.get(url, headers=headers)
8

9
print(response.json())

1
import httpx
2

3
url = "https://retidal.com/api/projects/%3Cstring%3E/email/triggers"
4

5
cookies = {"trackly_session": "<YOUR_API_KEY>"}
6

7
response = httpx.get(url, cookies=cookies)
8

9
print(response.json())

1
package main
2

3
import (
4
  "fmt"
5
  "net/http"
6
  "io"
7
)
8

9
func main() {
10

11
  url := "https://retidal.com/api/projects/%3Cstring%3E/email/triggers"
12

13
  req, _ := http.NewRequest("GET", url, nil)
14

15
  req.Header.Add("cookie", "trackly_session=%3CYOUR_API_KEY%3E")
16

17
  res, _ := http.DefaultClient.Do(req)
18

19
  defer res.Body.Close()
20
  body, _ := io.ReadAll(res.Body)
21

22
  fmt.Println(res)
23
  fmt.Println(string(body))
24

25
}

200Triggers.

1
{
2
  "triggers": [
3
    {
4
      "match": {
5
        "userFilter": {
6
          "queueKey": "new_paid_activation"
7
        }
8
      },
9
      "category": "transactional",
10
      "guardrails": {
11
        "quietHoursMode": "defer"
12
      }
13
    }
14
  ]
15
}

List event triggers

Authorizations

Parameters

Path Parameters

Responses

200

401

Examplegenerated

403

Examplegenerated

Example^generated

Example^generated