Quick Start

Follow these steps to get started within minutes.

• Before you start
• Step 1: Open postman or similar tool
• Step 2: Set authorization to OAuth 2.0
• Step 3: Create share
• Step 4: Upload files
• Step 5: Receive secure share

Before you start

Create a Signicat account and read our get started guide Learn how to create and use API tokens

Step 1: Open postman or similar tool

Our developers like to use Postman. It can be downloaded from https://www.getpostman.com (opens new window).

Step 2: Set authorization to OAuth 2.0

1. Click Get New Access token
2. Add your credentials
3. Request and use token

Step 3: Create share

1. Set URL to https://api.signicat.io/share/buckets/
2. HTTP verb POST
3. Body raw → application/json
4. Paste the json below into body
5. Click Send

POST https://api.signicat.io/share/buckets/

Request sample

{
  "information": {
    "title": "Title",
    "description": "Description of the filshare"
  },
  "content": [
    {
      "id": "1",
      "name": "testing1.pdf",
      "type": "file"
    }
  ],
  "recipients": [
    {
      "firstName": "Tony",
      "lastName": "Stark",
      "email": "customeremail@signicat.io",
      "expires": "2019-05-25T11:42:13.0568771+00:00",
      "mobile": {
        "countryCode": "47",
    "number": "12334568"
      },
      "uploads": [
        "1"
      ],
      "authentication": [],
      "notification": {
        "setup": {
          "request": "SendBoth",
          "reminder": "Off"
        },
        "language": "NO"
      },
      "oneTimeLogin": false
    }
  ]
}

Step 4: Upload files

In the response from step 3, you'll get an ID. You'll use this now when you upload files to the share via Postman.

1. Set url to https://api.signicat.io/share/{id}/file/{fileId}
2. HTTP verb POST
3. Body raw → form-data
4. Change key from text → File
5. Use the file picker to chose the files you want to add
6. Click Send
7. Repeat for all registered uploads

Step 5: Receive secure share

You will now receive an email/SMS on the email or phone number specified earlier. Open the link and login with an ID method of your choice. You can now download the files.