Create Account List Entry

curl --request POST \
  --url https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entry": "<string>",
  "reason": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}"

payload = {
    "entry": "<string>",
    "reason": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({entry: '<string>', reason: '<string>'})
};

fetch('https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'entry' => '<string>',
    'reason' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}"

	payload := strings.NewReader("{\n  \"entry\": \"<string>\",\n  \"reason\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"entry\": \"<string>\",\n  \"reason\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"entry\": \"<string>\",\n  \"reason\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "entry": "<string>",
  "organization_id": "<string>",
  "direction": "send",
  "list_type": "allow",
  "entry_type": "email",
  "created_at": "2023-11-07T05:31:56Z",
  "reason": "<string>",
  "read_only": true
}

{
  "name": "<string>",
  "errors": "<unknown>"
}

POST

https://api.aisa.one/apis/v1

agentmail

lists

{direction}

{type}

Create Account List Entry

curl --request POST \
  --url https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entry": "<string>",
  "reason": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}"

payload = {
    "entry": "<string>",
    "reason": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({entry: '<string>', reason: '<string>'})
};

fetch('https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'entry' => '<string>',
    'reason' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}"

	payload := strings.NewReader("{\n  \"entry\": \"<string>\",\n  \"reason\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"entry\": \"<string>\",\n  \"reason\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"entry\": \"<string>\",\n  \"reason\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "entry": "<string>",
  "organization_id": "<string>",
  "direction": "send",
  "list_type": "allow",
  "entry_type": "email",
  "created_at": "2023-11-07T05:31:56Z",
  "reason": "<string>",
  "read_only": true
}

{
  "name": "<string>",
  "errors": "<unknown>"
}

Adds one address or domain to an account-wide allow or block list and returns the created entry. 🔴 This is a standing rule that changes mail handling for every inbox in the account, including other callers’ — the inbox-scoped post_agentmail_inbox_list_entry affects only one inbox and is almost always the one you want. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created.

Example

curl -X POST "https://api.aisa.one/apis/v1/agentmail/lists/{direction}/{type}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization

string

required

Bearer authentication

Path Parameters

direction

enum<string>

required

Direction of list entry.

Available options:

send,

receive,

reply

type

enum<string>

required

Type of list entry.

Available options:

allow,

block

Body

application/json

entry

string

required

Email address or domain to add.

reason

string

Reason for adding the entry.

Response

Response with status 200

entry

string

required

Email address or domain of list entry.

organization_id

string

required

ID of organization.

direction

enum<string>

required

Direction of list entry.

Available options:

send,

receive,

reply

list_type

enum<string>

required

Type of list entry.

Available options:

allow,

block

entry_type

enum<string>

required

Whether the entry is an email address or domain.

Available options:

email,

domain

created_at

string<date-time>

required

Time at which entry was created.

reason

string

Reason for adding the entry.

read_only

boolean

Whether the entry is read-only and cannot be deleted via the API.

Overview

Chat API

Embeddings & Rerank

Search API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

SimilarWeb API

Essentials

Create Account List Entry

Example

Authorizations

Headers

Path Parameters

Body

Response

​Example

Authorizations

Headers

Path Parameters

Body

Response

Example