Communications
returns company email settings
Lists the company’s transactional email settings — one per email type Fluid can send (order confirmations, refund receipts, subscription reminders and billing notices, messaging notifications, and so on) — with whether each is currently enabled and its default. Settings for any email type the company has not stored yet are created with their defaults on first read, so the list is always complete. Not paginated. Requires a company admin token with the company_settings.view permission.
GET
/
api
/
v2025-06
/
company-email-settings
returns company email settings
curl --request GET \
--url https://api.fluid.app/api/v2025-06/company-email-settings \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v2025-06/company-email-settings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/v2025-06/company-email-settings', 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.fluid.app/api/v2025-06/company-email-settings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v2025-06/company-email-settings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v2025-06/company-email-settings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v2025-06/company-email-settings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"company_email_settings": [
{
"id": 90412,
"email_type": "order_confirmation",
"active": true,
"description": "Order confirmation emails sent to customers after purchase",
"metadata": {},
"created_at": "2026-09-02T14:18:26.000Z",
"updated_at": "2026-09-02T14:18:26.000Z",
"email_type_info": {
"name": "order_confirmation",
"description": "Order confirmation emails sent to customers after purchase",
"default_active": true
},
"default_active": true
},
{
"id": 90413,
"email_type": "order_admin_notification",
"active": true,
"description": "Order notifications sent to company administrators",
"metadata": {},
"created_at": "2026-09-02T14:18:26.000Z",
"updated_at": "2026-09-02T14:18:26.000Z",
"email_type_info": {
"name": "order_admin_notification",
"description": "Order notifications sent to company administrators",
"default_active": true
},
"default_active": true
},
{
"id": 90420,
"email_type": "subscription_reminder",
"active": false,
"description": "Subscription renewal reminder emails",
"metadata": {},
"created_at": "2026-09-02T14:18:26.000Z",
"updated_at": "2026-09-02T14:18:26.000Z",
"email_type_info": {
"name": "subscription_reminder",
"description": "Subscription renewal reminder emails",
"default_active": true
},
"default_active": true
}
],
"meta": {
"request_id": "c7d2a915-4e3b-4f81-9a6c-2b8e5d1f7a40",
"timestamp": "2026-09-30T16:42:11Z"
}
}{
"message": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 123,
"prev_cursor": "<string>",
"next_cursor": "<string>",
"total_count": 123
}
}
}⌘I
returns company email settings
curl --request GET \
--url https://api.fluid.app/api/v2025-06/company-email-settings \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v2025-06/company-email-settings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/v2025-06/company-email-settings', 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.fluid.app/api/v2025-06/company-email-settings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v2025-06/company-email-settings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v2025-06/company-email-settings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v2025-06/company-email-settings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"company_email_settings": [
{
"id": 90412,
"email_type": "order_confirmation",
"active": true,
"description": "Order confirmation emails sent to customers after purchase",
"metadata": {},
"created_at": "2026-09-02T14:18:26.000Z",
"updated_at": "2026-09-02T14:18:26.000Z",
"email_type_info": {
"name": "order_confirmation",
"description": "Order confirmation emails sent to customers after purchase",
"default_active": true
},
"default_active": true
},
{
"id": 90413,
"email_type": "order_admin_notification",
"active": true,
"description": "Order notifications sent to company administrators",
"metadata": {},
"created_at": "2026-09-02T14:18:26.000Z",
"updated_at": "2026-09-02T14:18:26.000Z",
"email_type_info": {
"name": "order_admin_notification",
"description": "Order notifications sent to company administrators",
"default_active": true
},
"default_active": true
},
{
"id": 90420,
"email_type": "subscription_reminder",
"active": false,
"description": "Subscription renewal reminder emails",
"metadata": {},
"created_at": "2026-09-02T14:18:26.000Z",
"updated_at": "2026-09-02T14:18:26.000Z",
"email_type_info": {
"name": "subscription_reminder",
"description": "Subscription renewal reminder emails",
"default_active": true
},
"default_active": true
}
],
"meta": {
"request_id": "c7d2a915-4e3b-4f81-9a6c-2b8e5d1f7a40",
"timestamp": "2026-09-30T16:42:11Z"
}
}{
"message": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 123,
"prev_cursor": "<string>",
"next_cursor": "<string>",
"total_count": 123
}
}
}