JavaScript SDK

   npm install Cocoonmail

import { CocoonmailClient } from "Cocoonmail";

const Cocoonmail = new CocoonmailClient(process.env.COCOONMAIL_API_KEY);

const resp = await Cocoonmail.createContact("email@provider.com");

const resp = await Cocoonmail.createContact("hello@gmail.com");

const contactProperties = {
  firstName: "Bob" /* Default property */,
  favoriteColor: "Red" /* Custom property */,
};
const mailingLists = {
  list_123: true,
  list_456: false,
};
const resp = await Cocoonmail.createContact(
  "hello@gmail.com",
  contactProperties,
  mailingLists
);

{
  "success": true,
  "id": "id_of_contact"
}

{
  "success": false,
  "message": "An error message here."
}

const contactProperties = {
  firstName: "Bob" /* Default property */,
  favoriteColor: "Blue" /* Custom property */,
};
const resp = await Cocoonmail.updateContact("hello@gmail.com", contactProperties);

/* Updating a contact's email address using userId */
const resp = await Cocoonmail.updateContact("newemail@gmail.com", {
  userId: "1234",
});

{
  "success": true,
  "id": "id_of_contact"
}

{
  "success": false,
  "message": "An error message here."
}

const resp = await Cocoonmail.findContact({ email: "hello@gmail.com" });

const resp = await Cocoonmail.findContact({ userId: "12345" });

[
  {
    "id": "cll6b3i8901a9jx0oyktl2m4u",
    "email": "hello@gmail.com",
    "firstName": "Bob",
    "lastName": null,
    "source": "API",
    "subscribed": true,
    "userGroup": "",
    "userId": "12345",
    "favoriteColor": "Blue" /* Custom property */
  }
]

const resp = await Cocoonmail.deleteContact({ email: "hello@gmail.com" });

const resp = await Cocoonmail.deleteContact({ userId: "12345" });

{
  "success": true,
  "message": "Contact deleted."
}

{
  "success": false,
  "message": "An error message here."
}

const resp = await Cocoonmail.getMailingLists();

[
  {
    "id": "list_123",
    "name": "Main list"
  },
  {
    "id": "list_456",
    "name": "Investors"
  }
]

const resp = await Cocoonmail.sendEvent({
  email: "hello@gmail.com",
  eventName: "signup",
});

const resp = await Cocoonmail.sendEvent({
  email: "hello@gmail.com",
  eventName: "signup",
  eventProperties: {
    username: "user1234",
    signupDate: "2024-03-21T10:09:23Z",
  },
  mailingLists: {
    list_123: true,
    list_456: false,
  },
});

// In this case with both email and userId present, the system will look for a contact with either a
//  matching `email` or `userId` value.
// If a contact is found for one of the values (e.g. `email`), the other value (e.g. `userId`) will be updated.
// If a contact is not found, a new contact will be created using both `email` and `userId` values.
// Any values added in `contactProperties` will also be updated on the contact.
const resp = await Cocoonmail.sendEvent({
  userId: "1234567890",
  email: "hello@gmail.com",
  eventName: "signup",
  contactProperties: {
    firstName: "Bob",
    plan: "pro",
  },
});

{
  "success": true
}

{
  "success": false,
  "message": "An error message here."
}

const dataVariables = {
  loginUrl: "https://myapp.com/login/",
};
const resp = await Cocoonmail.sendTransactionalEmail(
  "clfq6dinn000yl70fgwwyp82l",
  "hello@gmail.com",
  dataVariables
);

// Please contact us to enable attachments on your account.
const attachments = [
  {
    filename: "presentation.pdf",
    contentType: "application/pdf",
    data: "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPD...",
  },
];
const resp = await Cocoonmail.sendTransactionalEmail(
  "clfq6dinn000yl70fgwwyp82l",
  "hello@gmail.com",
  dataVariables,
  attachments
);

{
  "success": true
}

{
  "success": false,
  "path": "dataVariables",
  "message": "There are required fields for this email. You need to include a 'dataVariables' object with the required fields."
}

{
  "success": false,
  "error": {
    "path": "dataVariables",
    "message": "Missing required fields: login_url"
  },
  "transactionalId": "clfq6dinn000yl70fgwwyp82l"
}

const resp = await Cocoonmail.getCustomFields();

[
  {
    "key": "favoriteColor",
    "label": "Favorite Color",
    "type": "string"
  },
  {
    "key": "plan",
    "label": "Plan",
    "type": "string"
  }
]