# Quick Start

Follow these steps to get started within minutes.

# 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.

# Step 2: Set authorization to OAuth 2.0

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

Postman view showing authorization token click-to-zoom

# Step 3: Create share

  1. Set URL to https://api.idfy.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.idfy.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@idfy.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
    }
  ]
}

JSON sample view click-to-zoom

# 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.idfy.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

Postman view showing upload click-to-zoom

# 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.

Last updated: 9/18/2020, 7:53:29 AM