# Inboxes

> Shared inboxes over the API: inboxes, labels, threads and their emails, drafts and the AI agent settings.

An inbox is one address on a domain you can send from. Mail to it is kept as **threads** (conversations) that you can file in folders (inbox, archive, spam, trash), label and assign to a teammate. Each thread's messages stay under Emails too — deleting a thread or an inbox never deletes the mail.

Reads need an API key with read access; changes and sends need a full-access key (a sending-only key cannot reach inbox mail). Errors use the usual `{ statusCode, name, message }` shape; inbox errors add a `code` such as `receiving_choice_required` or `address_taken`.

> **Note:** Webhook events: `inbox.created`, `inbox.updated`, `inbox.deleted`, `inbox.email.received`, `inbox.email.sent`, `inbox.thread.created`, `inbox.thread.assigned`, `inbox.thread.unassigned`, `inbox.thread.folder.updated`, `inbox.thread.labels.updated`, `inbox.draft.created`, `inbox.draft.updated`, `inbox.draft.deleted` and `inbox.draft.sent`. Each carries the object as this page shows it. Mail flagged as spam on arrival is filed silently.

## Create inbox

`POST /inboxes`

The domain must be verified for sending. When it does not receive mail yet, say how the inbox should receive: `domain` turns receiving on (add the MX record from the domain page), `forward` gives the inbox an address to forward an existing mailbox to.

**Body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `email_address` | string | Yes | The full address. Or send `local` plus `domain_id`. |
| `name` | string | No | A display name for the inbox. |
| `from_name` | string | No | The name recipients see on mail sent from it. |
| `receiving` | 'domain' | 'forward' | No | Required only when the domain does not receive mail yet. |

> **Warning:** Inboxes beyond your plan answer `402 inbox_limit_reached` with the usual `limit` details, unless pay-as-you-go is on.

```json
{
  "object": "inbox",
  "id": "inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a",
  "address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support",
  "view_mode": "list",
  "domain_id": "4dd369bc-aa82-4ff3-97de-514ae3000ee0",
  "domain": "example.com",
  "receiving": "ready",
  "forward_address": null,
  "unread": 3,
  "drafts": 1,
  "last_received_at": "2026-11-20T09:14:00.000Z",
  "created_at": "2026-11-01T12:00:00.000Z"
}
```

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "email_address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support"
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "email_address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support"
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "email_address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.post(
    "https://www.senddart.com/api/inboxes",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "email_address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support"
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("POST", "https://www.senddart.com/api/inboxes", strings.NewReader(`{
  "email_address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support"
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .post("https://www.senddart.com/api/inboxes")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "email_address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support"
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "email_address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support"
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.senddart.com/api/inboxes");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""email_address"": ""support@example.com"",
  ""name"": ""Customer support"",
  ""from_name"": ""Ada from Support""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X POST 'https://www.senddart.com/api/inboxes' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "email_address": "support@example.com",
  "name": "Customer support",
  "from_name": "Ada from Support"
}'
```

## Retrieve inbox

`GET /inboxes/:inbox_id`

One inbox, with its unread and draft counts.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## List inboxes

`GET /inboxes`

Newest first, as `{ object: "list", has_more, data }`.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | number | No | 1–100. Omit to get every row (up to 1,000). |
| `after` | string | No | Id of the last row of the previous page. |
| `before` | string | No | Id of the first row of the next page. Not with `after`. |

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Update inbox

`PATCH /inboxes/:inbox_id`

Change `name`, `from_name` or `view_mode` (list, grouped or board). Answers the updated inbox.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "name": "Support",
  "from_name": "Ada from Support"
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Patch.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "name": "Support",
  "from_name": "Ada from Support"
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "name": "Support",
  "from_name": "Ada from Support"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.patch(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "name": "Support",
  "from_name": "Ada from Support"
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("PATCH", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a", strings.NewReader(`{
  "name": "Support",
  "from_name": "Ada from Support"
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .patch("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "name": "Support",
  "from_name": "Ada from Support"
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Support",
  "from_name": "Ada from Support"
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Patch, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""name"": ""Support"",
  ""from_name"": ""Ada from Support""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X PATCH 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Support",
  "from_name": "Ada from Support"
}'
```

## Delete inbox

`DELETE /inboxes/:inbox_id`

Removes the inbox with its threads, labels and drafts. Answers `{ object: "inbox", id, deleted: true }`.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Delete.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.delete(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("DELETE", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .delete("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X DELETE 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Create label

`POST /inboxes/:inbox_id/labels`

Names are unique per inbox, ignoring case. `color` is one of gray, red, orange, amber, green, teal, blue, violet or pink (default gray).

```json
{ "object": "inbox_label", "id": "lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c", "inbox_id": "inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a", "name": "Urgent", "color": "red", "threads": 0 }
```

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "name": "Urgent",
  "color": "red"
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "name": "Urgent",
  "color": "red"
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "name": "Urgent",
  "color": "red"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.post(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "name": "Urgent",
  "color": "red"
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("POST", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels", strings.NewReader(`{
  "name": "Urgent",
  "color": "red"
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .post("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "name": "Urgent",
  "color": "red"
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Urgent",
  "color": "red"
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""name"": ""Urgent"",
  ""color"": ""red""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X POST 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Urgent",
  "color": "red"
}'
```

## List labels

`GET /inboxes/:inbox_id/labels`

Every label, by name, with how many threads carry it.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | number | No | 1–100. Omit to get every row (up to 1,000). |
| `after` | string | No | Id of the last row of the previous page. |
| `before` | string | No | Id of the first row of the next page. Not with `after`. |

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Update label

`PATCH /inboxes/:inbox_id/labels/:label_id`

Change `name` and/or `color`. Answers the label.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "color": "orange"
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Patch.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "color": "orange"
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "color": "orange"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.patch(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "color": "orange"
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("PATCH", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c", strings.NewReader(`{
  "color": "orange"
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .patch("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "color": "orange"
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("""
{
  "color": "orange"
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Patch, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""color"": ""orange""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X PATCH 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "color": "orange"
}'
```

## Delete label

`DELETE /inboxes/:inbox_id/labels/:label_id`

Takes the label off every thread; the threads stay.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Delete.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.delete(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("DELETE", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .delete("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X DELETE 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## List threads

`GET /inboxes/:inbox_id/threads`

One page of conversations, most recently active first. Page forward with `after` (the last thread id).

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `folder` | string | No | inbox (default), sent, archive, spam or trash. |
| `label` | string | No | Only threads carrying this label id. |
| `query` | string | No | Search words and operators: `from:` `to:` `label:` `has:attachment` `is:unread` `is:assigned` `after:YYYY-MM-DD` `before:YYYY-MM-DD`. |
| `from, to` | string | No | Comma-separated addresses. |
| `start_date, end_date` | YYYY-MM-DD | No | Last activity on or after / before these days. |
| `unread` | boolean | No | Only unread (true) or read (false) threads. |
| `limit, after` | number, string | No | Page size (1–100, default 20) and cursor. |

```json
{ "object": "list", "has_more": false, "data": [{
    "object": "inbox_thread",
    "id": "thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d",
    "inbox_id": "inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a",
    "subject": "Refund for order 1041",
    "snippet": "Hi, I was charged twice for…",
    "participants": [{ "a": "carol@example.org", "n": "Carol" }],
    "folder": "inbox",
    "unread": true,
    "assignee": null,
    "messages": 2,
    "sent_only": false,
    "has_attachments": false,
    "has_draft": false,
    "labels": [{ "id": "lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c", "name": "Billing", "color": "amber" }],
    "column": null,
    "last_message_at": "2026-11-20T09:14:00.000Z",
    "trashed_at": null
  }] }
```

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads?folder=inbox&limit=20' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Search threads

`GET /inboxes/:inbox_id/threads/search`

The same list and parameters. A search or a label looks across Inbox, Sent and Archive unless `folder` is spam or trash.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/search?query=invoice&from=carol@example.org&start_date=2026-09-01&limit=2' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Retrieve thread

`GET /inboxes/:inbox_id/threads/:thread_id`

One conversation. Its messages are under …/emails.

```json
{
  "object": "inbox_thread",
  "id": "thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d",
  "inbox_id": "inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a",
  "subject": "Refund for order 1041",
  "snippet": "Hi, I was charged twice for…",
  "participants": [{ "a": "carol@example.org", "n": "Carol" }],
  "folder": "inbox",
  "unread": true,
  "assignee": null,
  "messages": 2,
  "sent_only": false,
  "has_attachments": false,
  "has_draft": false,
  "labels": [{ "id": "lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c", "name": "Billing", "color": "amber" }],
  "column": null,
  "last_message_at": "2026-11-20T09:14:00.000Z",
  "trashed_at": null
}
```

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Update thread

`PATCH /inboxes/:inbox_id/threads/:thread_id`

Any of `folder`, `read` (or `unread`) and `assignee` (a teammate's address, or null to unassign). Answers the thread.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "read": true,
  "folder": "archive"
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Patch.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "read": true,
  "folder": "archive"
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "read": true,
  "folder": "archive"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.patch(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "read": true,
  "folder": "archive"
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("PATCH", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d", strings.NewReader(`{
  "read": true,
  "folder": "archive"
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .patch("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "read": true,
  "folder": "archive"
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("""
{
  "read": true,
  "folder": "archive"
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Patch, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""read"": true,
  ""folder"": ""archive""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X PATCH 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "read": true,
  "folder": "archive"
}'
```

## Delete thread

`DELETE /inboxes/:inbox_id/threads/:thread_id`

Moves the thread to Trash (kept 30 days) and answers `deleted: false, folder: "trash"`; a thread already in Trash is removed for good (`deleted: true`).

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Delete.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.delete(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("DELETE", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .delete("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X DELETE 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Add thread labels

`POST /inboxes/:inbox_id/threads/:thread_id/labels`

Adds labels of this inbox. Answers the thread.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.post(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("POST", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels", strings.NewReader(`{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .post("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""labels"": [""lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c""]
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X POST 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}'
```

## Set thread labels

`PUT /inboxes/:inbox_id/threads/:thread_id/labels`

Makes these the thread's only labels; `[]` clears them.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Put.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.put(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("PUT", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels", strings.NewReader(`{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .put("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("PUT", HttpRequest.BodyPublishers.ofString("""
{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""labels"": [""lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c""]
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X PUT 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "labels": ["lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"]
}'
```

## Remove thread label

`DELETE /inboxes/:inbox_id/threads/:thread_id/labels/:label_id`

Takes one label off the thread. Answers the thread.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Delete.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.delete(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("DELETE", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .delete("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X DELETE 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/labels/lbl_5c2e9a1d7b4f8e3c6a0d2b9f1e4c' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## List thread emails

`GET /inboxes/:inbox_id/threads/:thread_id/emails`

Every message of the thread, oldest first, with `direction` (in / out), addresses, `html`, `text`, attachments and, for mail you sent, its delivery `status`. `source_id` is the message's id under Emails.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Retrieve thread email

`GET /inboxes/:inbox_id/threads/:thread_id/emails/:email_id`

One message of the thread.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Reply to thread email

`POST /inboxes/:inbox_id/threads/:thread_id/emails/:email_id/reply`

Goes to the sender — everyone on the message with `reply_all: true` — unless you pass `to`. It keeps the conversation together in the recipient's mail client and quotes the original.

**Body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `html, text` | string | Yes | Your message (one of them). |
| `to, cc, bcc` | string[] | No | Recipients. |
| `subject` | string | No | Defaults to "Re: " and the original subject. |
| `reply_all` | boolean | No | Reply to everyone on the message. |
| `attachments` | object[] | No | As on POST /emails: `{ filename, content }` or `{ filename, path }`. |

> **Note:** Sends need a full-access API key. The message goes out from the inbox address through the normal send pipeline — the same quota, suppression and domain checks as `POST /emails` — and is filed in the conversation. Send an `Idempotency-Key` header to make a retry safe.

```json
{ "object": "email", "id": "0b4f8a1c-6d2e-4f9a-b3c7-1e5d9a2f6b8c", "inbox_id": "inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a", "thread_id": "thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d" }
```

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "text": "Refund issued for order 1041.",
  "cc": ["billing@example.com"]
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "text": "Refund issued for order 1041.",
  "cc": ["billing@example.com"]
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "text": "Refund issued for order 1041.",
  "cc": ["billing@example.com"]
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.post(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "text": "Refund issued for order 1041.",
  "cc": ["billing@example.com"]
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("POST", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply", strings.NewReader(`{
  "text": "Refund issued for order 1041.",
  "cc": ["billing@example.com"]
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .post("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "text": "Refund issued for order 1041.",
  "cc": ["billing@example.com"]
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "text": "Refund issued for order 1041.",
  "cc": ["billing@example.com"]
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""text"": ""Refund issued for order 1041."",
  ""cc"": [""billing@example.com""]
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X POST 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/reply' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "text": "Refund issued for order 1041.",
  "cc": ["billing@example.com"]
}'
```

## Forward thread email

`POST /inboxes/:inbox_id/threads/:thread_id/emails/:email_id/forward`

`to` is required. The original follows your text, with its received files attached.

> **Note:** Sends need a full-access API key. The message goes out from the inbox address through the normal send pipeline — the same quota, suppression and domain checks as `POST /emails` — and is filed in the conversation. Send an `Idempotency-Key` header to make a retry safe.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "to": ["colleague@example.org"],
  "text": "Can you take this one?"
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "to": ["colleague@example.org"],
  "text": "Can you take this one?"
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "to": ["colleague@example.org"],
  "text": "Can you take this one?"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.post(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "to": ["colleague@example.org"],
  "text": "Can you take this one?"
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("POST", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward", strings.NewReader(`{
  "to": ["colleague@example.org"],
  "text": "Can you take this one?"
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .post("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "to": ["colleague@example.org"],
  "text": "Can you take this one?"
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "to": ["colleague@example.org"],
  "text": "Can you take this one?"
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""to"": [""colleague@example.org""],
  ""text"": ""Can you take this one?""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X POST 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/threads/thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d/emails/msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f/forward' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "to": ["colleague@example.org"],
  "text": "Can you take this one?"
}'
```

## Create draft

`POST /inboxes/:inbox_id/drafts`

`mode` is compose (default), reply, reply_all or forward; the last three answer `email_id`, a thread email. A message has one open answer at a time: asking again returns it.

**Body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `mode` | string | No | compose, reply, reply_all or forward. |
| `email_id` | string | No | The thread email being answered (not for compose). |
| `to, cc, bcc, subject, html, text` | … | No | The message so far. Recipients are checked when it is sent. |
| `attachments` | object[] | No | `{ filename, content (base64), content_type }`; up to 3 MB in total. |

```json
{
  "object": "inbox_draft",
  "id": "idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b",
  "inbox_id": "inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a",
  "mode": "reply",
  "thread_id": "thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d",
  "reply_to_id": "msg_2a7f4c9e1d6b3a8f5c0e2d7b9a4f",
  "to": ["carol@example.org"], "cc": [], "bcc": [],
  "subject": "Re: Refund for order 1041",
  "html": "<p>Refund issued.</p>",
  "text": "",
  "attachments": [],
  "author": "ada@example.com",
  "updated_at": "2026-11-20T09:20:00.000Z"
}
```

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "to": ["carol@example.org"],
  "subject": "Your order",
  "html": "<p>Hello</p>"
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "to": ["carol@example.org"],
  "subject": "Your order",
  "html": "<p>Hello</p>"
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "to": ["carol@example.org"],
  "subject": "Your order",
  "html": "<p>Hello</p>"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.post(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "to": ["carol@example.org"],
  "subject": "Your order",
  "html": "<p>Hello</p>"
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("POST", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts", strings.NewReader(`{
  "to": ["carol@example.org"],
  "subject": "Your order",
  "html": "<p>Hello</p>"
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .post("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "to": ["carol@example.org"],
  "subject": "Your order",
  "html": "<p>Hello</p>"
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "to": ["carol@example.org"],
  "subject": "Your order",
  "html": "<p>Hello</p>"
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""to"": [""carol@example.org""],
  ""subject"": ""Your order"",
  ""html"": ""<p>Hello</p>""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X POST 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "to": ["carol@example.org"],
  "subject": "Your order",
  "html": "<p>Hello</p>"
}'
```

## List drafts

`GET /inboxes/:inbox_id/drafts`

Unsent messages, most recently edited first.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | number | No | 1–100. Omit to get every row (up to 1,000). |
| `after` | string | No | Id of the last row of the previous page. |
| `before` | string | No | Id of the first row of the next page. Not with `after`. |

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Retrieve draft

`GET /inboxes/:inbox_id/drafts/:draft_id`

One draft.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Update draft

`PATCH /inboxes/:inbox_id/drafts/:draft_id`

Change any of to, cc, bcc, subject, html, text. Answers the draft.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "subject": "Refund issued for order 1041"
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Patch.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "subject": "Refund issued for order 1041"
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "subject": "Refund issued for order 1041"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.patch(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "subject": "Refund issued for order 1041"
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("PATCH", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b", strings.NewReader(`{
  "subject": "Refund issued for order 1041"
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .patch("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "subject": "Refund issued for order 1041"
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("""
{
  "subject": "Refund issued for order 1041"
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Patch, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""subject"": ""Refund issued for order 1041""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X PATCH 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "subject": "Refund issued for order 1041"
}'
```

## Delete draft

`DELETE /inboxes/:inbox_id/drafts/:draft_id`

Discards it.

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Delete.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.delete(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("DELETE", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .delete("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X DELETE 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Send draft

`POST /inboxes/:inbox_id/drafts/:draft_id/send`

Sends the draft and removes it.

> **Note:** Sends need a full-access API key. The message goes out from the inbox address through the normal send pipeline — the same quota, suppression and domain checks as `POST /emails` — and is filed in the conversation. Send an `Idempotency-Key` header to make a retry safe.

```json
{ "object": "email", "id": "0b4f8a1c-6d2e-4f9a-b3c7-1e5d9a2f6b8c", "inbox_id": "inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a", "thread_id": "thr_8d1e4b2c7a9f3e6d5c0b1a2f4e7d" }
```

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.post(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("POST", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .post("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X POST 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/drafts/idr_9b4e1c7a3f8d2e6b5c0a1f9d4e7b/send' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Retrieve agent settings

`GET /inboxes/:inbox_id/agent`

The inbox's AI agent settings. They shape the replies the agent suggests when someone asks for one; the agent never acts on its own.

```json
{
  "object": "inbox_agent",
  "inbox_id": "inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a",
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 },
  "available_actions": ["draft_reply", "apply_label", "assign", "archive", "mark_spam", "forward"],
  "updated_at": "2026-11-20T09:30:00.000Z"
}
```

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.get(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent",
    headers={"Authorization": "Bearer mb_xxxxxxxxx"},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent", nil)
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .get("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X GET 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent' \
  -H 'Authorization: Bearer mb_xxxxxxxxx'
```

## Update agent settings

`PATCH /inboxes/:inbox_id/agent`

Change any part; the rest is kept.

**Body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `instructions` | string | No | Up to 4,000 characters. |
| `actions` | string[] | No | What it may suggest: draft_reply, apply_label, assign, archive, mark_spam, forward. |
| `tone.length` | 0–100 | No | 0 concise … 100 expanded. |
| `tone.register` | 0–100 | No | 0 professional … 100 casual. |

**Node.js**

```js
const res = await fetch('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 }
}),
});
const data = await res.json();
console.log(data);
```

**Ruby**

```ruby
require 'net/http'
require 'uri'

uri = URI('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Patch.new(uri)
req['Authorization'] = 'Bearer mb_xxxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = <<~JSON
{
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 }
}
JSON
res = http.request(req)
puts res.body
```

**PHP**

```php
<?php
$ch = curl_init('https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mb_xxxxxxxxx',
        'User-Agent: my-app/1.0',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 }
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```

**Python**

```python
import requests

res = requests.patch(
    "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent",
    headers={"Authorization": "Bearer mb_xxxxxxxxx", "Content-Type": "application/json"},
    json={
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 }
},
)
print(res.json())
```

**Go**

```go
package main

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

func main() {
    req, _ := http.NewRequest("PATCH", "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent", strings.NewReader(`{
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 }
}`))
    req.Header.Set("Authorization", "Bearer mb_xxxxxxxxx")
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}
```

**Rust**

```rust
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = Client::new()
        .patch("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent")
        .header("Authorization", "Bearer mb_xxxxxxxxx")
        .header("User-Agent", "my-app/1.0")
        .header("Content-Type", "application/json")
        .body(r#"{
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 }
}"#)
        .send()
        .await?;
    println!("{}", res.text().await?);
    Ok(())
}
```

**Java**

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent"))
    .header("Authorization", "Bearer mb_xxxxxxxxx")
    .header("User-Agent", "my-app/1.0")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("""
{
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 }
}
"""))
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

**.NET**

```csharp
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Patch, "https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent");
request.Headers.Add("Authorization", "Bearer mb_xxxxxxxxx");
request.Headers.Add("User-Agent", "my-app/1.0");
request.Content = new StringContent(@"{
  ""instructions"": ""Answer refund questions. Hand legal questions to a person."",
  ""actions"": [""draft_reply"", ""apply_label""],
  ""tone"": { ""length"": 30, ""register"": 20 }
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

**cURL**

```bash
curl -X PATCH 'https://www.senddart.com/api/inboxes/inb_3f9c2a7d1e4b8c6a0f5d2e9b7c1a/agent' \
  -H 'Authorization: Bearer mb_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "instructions": "Answer refund questions. Hand legal questions to a person.",
  "actions": ["draft_reply", "apply_label"],
  "tone": { "length": 30, "register": 20 }
}'
```
