API Docs

By using this API you will have full access to the same range of features found in our apps and website.

1. API Endpoint

The API can be found at: https://api.simplynoted.com/api

All endpoints listed in this documentation refer to this base URL and build off it. For example, the login command “login” can be found at the endpoint: https://api.simplynoted.com/api/login

2. Authentication

2.1. Retrieve Auth Token

Description: Simply Noted uses API keys and bearer tokens to allow access to the API. You can request an API key from support, support@simplynote.com, or you can get a token from authenticating with your username and password. Simply Noted expects for the API key or token to be included in all API requests to the server in a header that looks like the following: Authorization: Bearer TOKEN

Endpoint: /login

Method: POST

Headers:

Name Value Required?
Content-Type application/json Yes

Params:

Parameter Type Required? Example
email String Yes "john@simplynoted.com"
password String Yes "supersecretpassword123"

Returns on success:

{
"result": {
  "token": "eyJ0eXAiOi.........",
  "user": {
    "_id": "5e0006e490773f3e8d2d02f1",
    "first_name": "John",
    "last_name": "Appleseed",
    "email": "john@simplynoted.com",
    "phone": "+15555551234",
    "updated": "2020-01-01T00:00:00.000Z",
    "created": "2020-01-01T00:00:00.000Z"
  }
},
"errors": []
}

Example:

{
"email": "john@simplynoted.com",
"password": "supersecretpassword123"
}

3. Users

3.1. Create A User

Description: This endpoint creates a User. If any required properties are missing an error will be returned.

Endpoint: /register

Method: POST

Headers:

Name Value Required?
Content-Type application/json Yes

Params:

Parameter Type Required? Example
customer Customer Object Yes See Below

Customer Object:

Parameter Type Required? Example
first_name String Yes "John"
last_name String Yes "Appleseed"
email String Yes "john@simplynoted.com"
phone String Yes "+15555551234"
addresses Array<Address Object> Yes See Below

Address Object:

Parameter Type Required? Example
address1 String Yes "123 S Street"
city String Yes "Metropolis"
province String No "Smallville"
phone String No "+15555551234"
zip String Yes "12345"
last_name String No "Appleseed"
first_name String No "John"
country String No "US"

Returns on success:

{
"result": {
  "addresses": [
    {
      "address1": "123 S Street",
      "city": "Metropolis",
      "province": "Smallville",
      "phone": "+15555551234",
      "zip": "12345",
      "last_name": "Appleseed",
      "first_name": "John",
      "country": "US"
    }
  ],
  "_id": "5e0006e490773f3e8d2d02f1",
  "first_name": "John",
  "last_name": "Appleseed",
  "email": "john@simplynoted.com",
  "phone": "+15555551234"
},
"errors": []
}

Example:

{
"customer": {
  "first_name": "John",
  "last_name": "Appleseed",
  "email": "john@simplynoted.com",
  "phone": "+15555551234",
  "addresses": [
    {
      "address1": "123 S Street",
      "city": "Metropolis",
      "province": "Smallville",
      "phone": "+15555551234",
      "zip": "12345",
      "last_name": "Appleseed",
      "first_name": "John",
      "country": "US"
    }
  ]
}
}

4. Products

4.1. Get All Products

Description: This endpoint gets all products and returns the id, title, and image URL.

Endpoint: /products

Method: GET

Headers:

Name Value Required?
Content-Type application/json Yes
Authorization Bearer TOKEN_HERE Yes

Returns on success:

{
"result": [
  {
    "id": 4392451768425,
    "title": "Cactus Thank you",
    "image": "https://cdn.shopify.com/s/files/1/0275/6457/2777/products/Cactus-Thank-You.jpg?v=1574659292"
  },
  {
    "id": 4392452522089,
    "title": "Cactus Thanks So Much",
    "image": "https://cdn.shopify.com/s/files/1/0275/6457/2777/products/Cactus-Thanks-So-Much.jpg?v=1574659363"
  },
  {
    "id": 4442013139049,
    "title": "Dark Red Holiday Card",
    "image": "https://cdn.shopify.com/s/files/1/0275/6457/2777/products/Red.HolidayCard.jpg?v=1576524937"
  }
],
"errors": []
}

5. Orders

5.1. Create An Order

Description: This endpoint creates an Order. If any required properties are missing an error will be returned.

Endpoint: /orders

Method: POST

Headers:

Name Value Required?
Content-Type application/json Yes
Authorization Bearer TOKEN_HERE Yes

Params:

Parameter Type Required? Example
productId String Yes "4392452522089"
handwritingStyle String Yes "Tarzan"
customMessage String Yes "This is my custom message"
shippingDate String No "01/01/2020"
templateId String No "12923422089"
recipientData Array<Recipient Object> Yes See Below

Recipient Object:

Parameter Type Required? Example
First Name String No "John"
Last Name String No "Appleseed"
Email String No "john@simplynoted.com"
Phone String No "+15555551234"
Address String Yes "123 S Street"
Address 2 String No "Suite 100"
City String Yes "Metropolis"
State String Yes "Smallville"
Zip String Yes "12345"
Company String No "ACME, Inc."
Custom 1 String No "My custom value"
Custom 2 String No "Another Ccustom value"
Custom 3 String No "And A third"

Returns on success:

{
"result": "Order created.",
"errors": []
}

Example:

{
"productId": "ID_OF_PRODUCT_YOU_ARE_ORDERING",
"handwritingStyle": "Tarzan",
"customMessage": "This is my custom message",
"shippingDate": "",
"templateId": "ID_OF_THE_TEMPLATE_YOU_WANT_TO_USE",
"recipientData": [
  {
    "First Name": "John",
    "Last Name": "Appleseed",
    "Address": "123 S Street",
    "Address 2": "",
    "City": "Metropolis",
    "State": "Smallville",
    "Zip": "12345",
    "Phone": "+15555551234",
    "Email": "john@simplynoted.com",
    "Company": "ACME, Inc.",
    "Custom 1": "",
    "Custom 2": "",
    "Custom 3": "",
  }
]
}

6. Payments

Please Note: For security reasons you cannot create or store cedit cards from the Simply Noted API. Credit cards can only be added via SimplyNoted.com. You can set up your stored credit card on your user's account page. https://simplynoted.com/account

To receive bulk discounts and a smoother checkout process please purchase Simply Noted Credits. These credits will be used for purchases made via API with stored credit card information referenced as a fallback when no credits are available. Simply Noted Credits can be purchased HERE.


6.1. Get All Stored Credit Cards

Description: This endpoint retrieves all credit cards stored on your account.

Endpoint: /creditcards

Method: GET

Headers:

Name Value Required?
Content-Type application/json Yes
Authorization Bearer TOKEN_HERE Yes

Returns on success:

{
"result": [
  {
    "_id": "4c1aa14ca35a0f00179355b0",
    "cardData": {
      "card_brand": "VISA",
      "last_4": "1111",
      "exp_month": 11,
      "exp_year": 2021,
      "cardholder_name": "Jane Doe",
      "billing_address": {
        "postal_code": "85251",
        "country": "US"
      }
    },
    "updated": "2020-01-12T04:32:12.846Z",
    "created": "2020-01-12T04:32:12.846Z"
  }
],
"errors": []
}

7. Templates

7.1. Create A Template

Description: This endpoint creates a Template. If any required properties are missing an error will be returned.

Endpoint: /templates

Method: POST

Headers:

Name Value Required?
Content-Type application/json Yes
Authorization Bearer TOKEN_HERE Yes

Params:

Parameter Type Required? Example
productId String Yes "4392452522089"
handwritingStyle String Yes "Tarzan"
customMessage String Yes "This is my custom message"

Returns on success:

{
"result": {
  "_id": "5e1b61a80d9234514cb1e983a",
  "productId": "4460979552361",
  "handwritingStyle": "Tarzan",
  "customMessage": "This is my custom message",
  "ownerId": "5e1a6f1d63458234017a962a3",
  "updated": "2020-01-01T00:00:00.000Z",
  "created": "2020-01-01T00:00:00.000Z",
  "__v": 0
},
"errors": []
}

Example:

{
"productId": "4460979552361",
"handwritingStyle": "Tarzan",
"customMessage": "This is my custom message"
}

7.2. Retrieve All Templates

Description: This endpoint gets all Templates.

Endpoint: /templates

Method: GET

Headers:

Name Value Required?
Content-Type application/json Yes
Authorization Bearer TOKEN_HERE Yes

Returns on success:

{
"result": [
  {
    "_id": "5e1b5123fe1a7f10021c2b04",
    "productId": "4460979552361",
    "handwritingStyle": "Tarzan",
    "customMessage": "This is my custom message",
    "ownerId": "5e1a6f1d616d871237a962a3",
    "updated": "2020-01-12T18:00:25.020Z",
    "created": "2020-01-12T18:00:25.020Z",
    "__v": 0
  },
  {
    "_id": "5e1b61a80d92f711231e983a",
    "productId": "4460979552361",
    "handwritingStyle": "Tarzan",
    "customMessage": "This is my custom message 2",
    "ownerId": "5e1a6f1d616d871237a962a3",
    "updated": "2020-01-12T18:12:56.945Z",
    "created": "2020-01-12T18:12:56.945Z",
    "__v": 0
  }
],
"errors": []
}

7.3. Retrieve A Single Template

Description: This endpoint gets a single Template.

Endpoint: /templates/:templateId

Method: GET

Headers:

Name Value Required?
Content-Type application/json Yes
Authorization Bearer TOKEN_HERE Yes

URL Parameters:

Parameter Type Required? Example
templateId String Yes "5e1b5123fe1a7f10021c2b04"

Returns on success:

{
"result": {
  "_id": "5e1b5123fe1a7f10021c2b04",
  "productId": "4460979552361",
  "handwritingStyle": "Tarzan",
  "customMessage": "This is my custom message",
  "ownerId": "5e1a6f1d616d871237a962a3",
  "updated": "2020-01-12T18:00:25.020Z",
  "created": "2020-01-12T18:00:25.020Z",
  "__v": 0
},
"errors": []
}

7.4. Update A Template

Description: This endpoint updates a Template. If any required properties are missing an error will be returned.

Endpoint: /templates/:templateId

Method: PUT

Headers:

Name Value Required?
Content-Type application/json Yes
Authorization Bearer TOKEN_HERE Yes

URL Parameters:

Parameter Type Required? Example
templateId String Yes "5e1b5123fe1a7f10021c2b04"

Params:

Parameter Type Required? Example
productId String Yes "4392452522089"
handwritingStyle String Yes "Stitch"
customMessage String Yes "This is my custom message"

Returns on success:

{
"result": {
  "productId": "4392452522089",
  "handwritingStyle": "Stitch",
  "customMessage": "This is my custom message"
},
"errors": []
}

Example:

{
"productId": "4392452522089",
"handwritingStyle": "Stitch",
"customMessage": "This is my custom message"
}

8. Available Handwriting Styles

7.1. Examples

Description: Below you can preview the available handwriting styles that can be leveraged by the API.

Tarzan:

The quick brown fox jumps over the lazy dog

Stitch:

The quick brown fox jumps over the lazy dog

Pinocchio:

The quick brown fox jumps over the lazy dog

Simba:

The quick brown fox jumps over the lazy dog

Roo:

The quick brown fox jumps over the lazy dog

Nemo:

The quick brown fox jumps over the lazy dog

Lumiere:

The quick brown fox jumps over the lazy dog

Kaa:

The quick brown fox jumps over the lazy dog

Dumbo:

The quick brown fox jumps over the lazy dog

Bolt:

The quick brown fox jumps over the lazy dog

Belle:

The quick brown fox jumps over the lazy dog

Cinderella:

The quick brown fox jumps over the lazy dog

Hercules:

The quick brown fox jumps over the lazy dog

Merlin:

The quick brown fox jumps over the lazy dog

Rapunzel:

The quick brown fox jumps over the lazy dog

Scar:

The quick brown fox jumps over the lazy dog

BACK TO TOP
Loading...