Download Attachment

GET

inbound

messages

{id}

attachments

{idx}

curl --request GET \
  --url https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999 \
  --header 'Authorization: Bearer as_your-api-key'

import requests

url = "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999"

headers = {
    "Authorization": "Bearer as_your-api-key"
}

response = requests.get(url, headers=headers)
data = response.json()

# Follow the pre-signed URL to download the file (no auth header needed).
file_url = data["data"]["downloadUrl"]
file = requests.get(file_url)
with open(data["data"]["filename"], "wb") as f:
    f.write(file.content)

const response = await fetch(
  'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer as_your-api-key'
    }
  }
);

const { data } = await response.json();

// Follow the pre-signed URL to download the file (no auth header needed).
const file = await fetch(data.downloadUrl);
const blob = await file.blob();
// Save or process the blob as needed

curl --request GET \
  --url 'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true' \
  --header 'Authorization: Bearer as_your-api-key' \
  --output receipt.pdf

import requests

url = "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0"

headers = {
    "Authorization": "Bearer as_your-api-key"
}

response = requests.get(url, headers=headers, params={"download": "true"})
with open("receipt.pdf", "wb") as f:
    f.write(response.content)

const response = await fetch(
  'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer as_your-api-key'
    }
  }
);

const blob = await response.blob();
// Save or process the blob as needed

<?php

$messageId = '60d5ec49f1b2c72d9c8b1234';
$index = 0;
$url = "https://api.autosend.com/v1/inbound/messages/{$messageId}/attachments/{$index}?download=true";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer as_your-api-key'
]);

$content = curl_exec($ch);
curl_close($ch);

file_put_contents('receipt.pdf', $content);
?>

package main

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

func main() {
    url := "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true"

    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer as_your-api-key")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    out, _ := os.Create("receipt.pdf")
    defer out.Close()
    io.Copy(out, resp.Body)
}

import java.io.InputStream;
import java.io.FileOutputStream;
import java.net.HttpURLConnection;
import java.net.URL;

public class DownloadAttachment {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true");
            HttpURLConnection con = (HttpURLConnection) url.openConnection();

            con.setRequestMethod("GET");
            con.setRequestProperty("Authorization", "Bearer as_your-api-key");

            try (InputStream in = con.getInputStream();
                 FileOutputStream out = new FileOutputStream("receipt.pdf")) {
                byte[] buffer = new byte[8192];
                int n;
                while ((n = in.read(buffer)) != -1) {
                    out.write(buffer, 0, n);
                }
            }
            con.disconnect();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

require 'net/http'
require 'uri'

uri = URI('https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true')

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

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer as_your-api-key'

response = http.request(request)
File.open('receipt.pdf', 'wb') { |f| f.write(response.body) }

{
  "success": true,
  "data": {
    "attachmentId": "att_60d5ec49f1b2c72d9c8b9999",
    "filename": "receipt.pdf",
    "contentType": "application/pdf",
    "size": 20480,
    "downloadUrl": "https://s3.amazonaws.com/autosend-inbound/attachments/60d5ec49f1b2c72d9c8b1234/att_60d5ec49f1b2c72d9c8b9999.pdf?X-Amz-Signature=...",
    "expiresIn": 900
  }
}

<binary attachment content>

Content-Type: application/pdf
Content-Disposition: attachment; filename="receipt.pdf"

This endpoint uses a standard project API key (AS_ prefix). It returns a single attachment from an inbound message, identified either by its attachmentId (recommended, stable) or by its zero-based index from the message’s attachments array.By default it returns JSON metadata with a short-lived, pre-signed download URL. Pass ?download=true to stream the raw bytes instead, with Content-Type and Content-Disposition: attachment; filename="…" headers.

curl --request GET \
  --url https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999 \
  --header 'Authorization: Bearer as_your-api-key'

import requests

url = "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999"

headers = {
    "Authorization": "Bearer as_your-api-key"
}

response = requests.get(url, headers=headers)
data = response.json()

# Follow the pre-signed URL to download the file (no auth header needed).
file_url = data["data"]["downloadUrl"]
file = requests.get(file_url)
with open(data["data"]["filename"], "wb") as f:
    f.write(file.content)

const response = await fetch(
  'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer as_your-api-key'
    }
  }
);

const { data } = await response.json();

// Follow the pre-signed URL to download the file (no auth header needed).
const file = await fetch(data.downloadUrl);
const blob = await file.blob();
// Save or process the blob as needed

curl --request GET \
  --url 'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true' \
  --header 'Authorization: Bearer as_your-api-key' \
  --output receipt.pdf

import requests

url = "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0"

headers = {
    "Authorization": "Bearer as_your-api-key"
}

response = requests.get(url, headers=headers, params={"download": "true"})
with open("receipt.pdf", "wb") as f:
    f.write(response.content)

const response = await fetch(
  'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer as_your-api-key'
    }
  }
);

const blob = await response.blob();
// Save or process the blob as needed

<?php

$messageId = '60d5ec49f1b2c72d9c8b1234';
$index = 0;
$url = "https://api.autosend.com/v1/inbound/messages/{$messageId}/attachments/{$index}?download=true";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer as_your-api-key'
]);

$content = curl_exec($ch);
curl_close($ch);

file_put_contents('receipt.pdf', $content);
?>

package main

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

func main() {
    url := "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true"

    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer as_your-api-key")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    out, _ := os.Create("receipt.pdf")
    defer out.Close()
    io.Copy(out, resp.Body)
}

import java.io.InputStream;
import java.io.FileOutputStream;
import java.net.HttpURLConnection;
import java.net.URL;

public class DownloadAttachment {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true");
            HttpURLConnection con = (HttpURLConnection) url.openConnection();

            con.setRequestMethod("GET");
            con.setRequestProperty("Authorization", "Bearer as_your-api-key");

            try (InputStream in = con.getInputStream();
                 FileOutputStream out = new FileOutputStream("receipt.pdf")) {
                byte[] buffer = new byte[8192];
                int n;
                while ((n = in.read(buffer)) != -1) {
                    out.write(buffer, 0, n);
                }
            }
            con.disconnect();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

require 'net/http'
require 'uri'

uri = URI('https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true')

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

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer as_your-api-key'

response = http.request(request)
File.open('receipt.pdf', 'wb') { |f| f.write(response.body) }

{
  "success": true,
  "data": {
    "attachmentId": "att_60d5ec49f1b2c72d9c8b9999",
    "filename": "receipt.pdf",
    "contentType": "application/pdf",
    "size": 20480,
    "downloadUrl": "https://s3.amazonaws.com/autosend-inbound/attachments/60d5ec49f1b2c72d9c8b1234/att_60d5ec49f1b2c72d9c8b9999.pdf?X-Amz-Signature=...",
    "expiresIn": 900
  }
}

<binary attachment content>

Content-Type: application/pdf
Content-Disposition: attachment; filename="receipt.pdf"

Authorizations

string | header

required

Project API key header of the form Bearer as_<key>. You can also pass the key via the x-api-key header.

Path Parameters

string

required

The unique identifier of the inbound message. The message must belong to the authenticated project.Example: "60d5ec49f1b2c72d9c8b1234"

string

required

Identifies the attachment. Accepts either the attachment’s attachmentId (recommended, stable across requests, e.g. att_60d5ec49f1b2c72d9c8b9999) or a zero-based index into the message’s attachments array (back-compat, e.g. 0).Example: att_60d5ec49f1b2c72d9c8b9999

Query Parameters

boolean

default:false

Controls the response format.

false (default): returns JSON metadata with a short-lived, pre-signed downloadUrl.
true: streams the raw attachment bytes with Content-Type and Content-Disposition headers.

Response

Attachment metadata retrieved successfully. With ?download=true, the body is instead the raw binary content and the Content-Type and Content-Disposition response headers describe the file.

boolean

Indicates if the request was successfulExample: true

object

Attachment metadata and download URL

Show child attributes

string

Stable identifier for this attachment. Use it as the {idx} path parameter for repeatable references.

string

Original file name of the attachment.

string

MIME type of the attachment (e.g. application/pdf).

integer

Size of the attachment in bytes.

string

Pre-signed URL to download the file. It requires no authentication header and downloads with the correct filename. Treat it as short-lived and single-use; request a fresh one once it expires.

integer

Number of seconds the downloadUrl stays valid. Currently 900 (15 minutes).

Error Responses

object

Returned when id is not valid or idx is neither a non-negative integer nor a valid attachmentId.

{
  "success": false,
  "error": {
      "message": "Invalid value",
    }
  
}

object

Returned when the message does not exist or does not belong to the authenticated project.

{
  "success": false,
  "error": {
    "message": "Inbound email not found"
  }
}

object

Returned when no attachment matches the given attachmentId or index.

{
  "success": false,
  "error": {
    "message": "Attachment not found"
  }
}

object

Returned when the message’s raw MIME source is not yet stored (the message may still be processing), so the attachment cannot be produced.

{
  "success": false,
  "error": {
    "message": "Raw MIME is not yet available for this message"
  }
}

object

Returned when an unexpected error occurs while producing the download URL or streaming the attachment.

{
  "success": false,
  "error": {
    "message": "Failed to download attachment. Please try again."
  }
}

curl --request GET \
  --url https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999 \
  --header 'Authorization: Bearer as_your-api-key'

import requests

url = "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999"

headers = {
    "Authorization": "Bearer as_your-api-key"
}

response = requests.get(url, headers=headers)
data = response.json()

# Follow the pre-signed URL to download the file (no auth header needed).
file_url = data["data"]["downloadUrl"]
file = requests.get(file_url)
with open(data["data"]["filename"], "wb") as f:
    f.write(file.content)

const response = await fetch(
  'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/att_60d5ec49f1b2c72d9c8b9999',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer as_your-api-key'
    }
  }
);

const { data } = await response.json();

// Follow the pre-signed URL to download the file (no auth header needed).
const file = await fetch(data.downloadUrl);
const blob = await file.blob();
// Save or process the blob as needed

curl --request GET \
  --url 'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true' \
  --header 'Authorization: Bearer as_your-api-key' \
  --output receipt.pdf

import requests

url = "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0"

headers = {
    "Authorization": "Bearer as_your-api-key"
}

response = requests.get(url, headers=headers, params={"download": "true"})
with open("receipt.pdf", "wb") as f:
    f.write(response.content)

const response = await fetch(
  'https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer as_your-api-key'
    }
  }
);

const blob = await response.blob();
// Save or process the blob as needed

<?php

$messageId = '60d5ec49f1b2c72d9c8b1234';
$index = 0;
$url = "https://api.autosend.com/v1/inbound/messages/{$messageId}/attachments/{$index}?download=true";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer as_your-api-key'
]);

$content = curl_exec($ch);
curl_close($ch);

file_put_contents('receipt.pdf', $content);
?>

package main

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

func main() {
    url := "https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true"

    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer as_your-api-key")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    out, _ := os.Create("receipt.pdf")
    defer out.Close()
    io.Copy(out, resp.Body)
}

import java.io.InputStream;
import java.io.FileOutputStream;
import java.net.HttpURLConnection;
import java.net.URL;

public class DownloadAttachment {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true");
            HttpURLConnection con = (HttpURLConnection) url.openConnection();

            con.setRequestMethod("GET");
            con.setRequestProperty("Authorization", "Bearer as_your-api-key");

            try (InputStream in = con.getInputStream();
                 FileOutputStream out = new FileOutputStream("receipt.pdf")) {
                byte[] buffer = new byte[8192];
                int n;
                while ((n = in.read(buffer)) != -1) {
                    out.write(buffer, 0, n);
                }
            }
            con.disconnect();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

require 'net/http'
require 'uri'

uri = URI('https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234/attachments/0?download=true')

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

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer as_your-api-key'

response = http.request(request)
File.open('receipt.pdf', 'wb') { |f| f.write(response.body) }

{
  "success": true,
  "data": {
    "attachmentId": "att_60d5ec49f1b2c72d9c8b9999",
    "filename": "receipt.pdf",
    "contentType": "application/pdf",
    "size": 20480,
    "downloadUrl": "https://s3.amazonaws.com/autosend-inbound/attachments/60d5ec49f1b2c72d9c8b1234/att_60d5ec49f1b2c72d9c8b9999.pdf?X-Amz-Signature=...",
    "expiresIn": 900
  }
}

<binary attachment content>

Content-Type: application/pdf
Content-Disposition: attachment; filename="receipt.pdf"

API Reference

Sending

Contacts

Contact Properties

Templates

Senders

Campaigns

Automations

Events

Domains

Contact Lists

Suppression Groups

Projects

Webhooks

Inbound Emails

Custom Fields

Authorizations

Path Parameters

Query Parameters

Response

Error Responses

​Authorizations

​Path Parameters

​Query Parameters

​Response

​Error Responses

Authorizations

Path Parameters

Query Parameters

Response

Error Responses