Overview

Archives an email.

Query String Parameters

This endpoint does not accept any query string parameters.

Input Parameters

Name Type Description Required
date_sent String Date of email sent True
from_address String From email address True
to_addresses Array Array of name/email address pairs for the TO field, when present, only email subfield is required (not name). True
cc_addresses Array Array of name/email address pairs for the CC field, when present, email subfield is required. False
bcc_addresses Array Array of name/email address pairs for the BCC field, when present, email subfield is required. False
subject String Subject of the email True
html_body String HTML body of the email False
text_body String Text body of the email False
status String Indicates the status of the email - 'draft' or 'ready' (ready to be sent) True
related Object Contains 'parent_type' and 'parent_id' to relate this email to (for example 'Contact' and a contact's id) False
teams Object Team(s) to assign this email to. 'primary' attribute is an id string for the primary team and 'other' attribute is an array of id strings for the other teams - only primary is required True
assigned_user_id String ID of a user this record is assigned to. False
attachments Array Array of file attachments - each attachment consists of a 'type' (where the attachment came from: upload, document, or template), 'id' (of the file upload, note, document revision, etc), and 'name' (the file name) False

Input Example

{
  "date_sent":"2014-02-07T00:00:00",
  "from_address":"test@foo.com"
  "to_addresses":[
    {
      "name":"John Doe",
      "email":"john_doe@foo.com",
      "module":"Leads"
    },
    {
      "name":"David Madison",
      "email":"david_madison@bar.com",
      "module":"Leads"
    }
  ],
  "cc_addresses":[
    {
      "name":"Tom Swift",
      "email":"tswift@baz.com"
    }
  ],
  "bcc_addresses":null,
  "subject":"Minneapolis Convention",
  "html_body":"<html><body>Hello World<\/body><\/html>",
  "text_body":"Hello World"
  "status":"archive",
  "related": {
    "type":"Contacts",
    "id":"61cf0f8d-938c-c9b2-53ad-51ed7bbcf83b"
  },
  "teams": {
    "primary": "dabec868-696c-f458-e204-50227995ab50",
    "others": [
      "c3094c88-c95f-2e17-4553-50227996ad20",
      "abcde868-696c-f458-e704-58369095ab62"
    ]
  },
  "assigned_user_id":"seed_jim_id",
  "attachments": [
    {
       "type": "upload”,
       "id": "cfbe4551-548d-f602-b228-45387645fc12",
       "name": "company_logo.jpg”
    },
    {
       "type": "document”,
       "id": "876112a4-89c1-4ba7-a05a-7729a7a76818"
    },
    {
       "type": "template”,
       "id": "002cfe6c-98e9-4342-bdb1-1660d0788872"
    }
  ],
}

Result

Name Type Description
<email record field> <email record field type> Returns the fields for the newly created email record.

Output Example

{
    "team_id": "9c61c46a-a7c5-df71-481c-51d48232f820",
    "team_set_id": "9c61c46a-a7c5-df71-481c-51d48232f820",
    "id": "d9c165d0-8863-ba61-dc85-51ed8016c476",
    "date_entered": "2013-07-22 18:57:57",
    "date_modified": "2013-07-22 18:57:57",
    "assigned_user_id": "1",
    "assigned_user_name": "",
    "modified_user_id": "1",
    "modified_by_name": "admin",
    "created_by": "1",
    "created_by_name": "",
    "deleted": 0,
    "from_addr_name": "SugarCRM",
    "reply_to_addr": "",
    "to_addrs_names": "john_doe@foo.com, david_madison@bar.com",
    "cc_addrs_names": "tswift@baz.com",
    "description_html": "<html><body>Hello World<\/body><\/html>",
    "description": "Hello World",
    "date_sent": "2013-07-22 18:57:00",
    "name": "Minneapolis Convention",
    "type": "out",
    "status": "sent",
    "parent_type": "Contacts",
    "parent_id": "61cf0f8d-938c-c9b2-53ad-51ed7bbcf83b",
    "from_address":"test@foo.com"
}

Change Log

Version Change
v11 Last version in which /Mail/archive POST is available. Use /Emails POST with {"state": "Archived"} instead.
v10 Added /Mail/archive POST endpoint.