Back to top

API Documentation

SkySlope

Overview

SkySlope is a real estate transaction management software used by real estate agents and brokers. It helps users manage documents, streamline compliance workflows, and track transactions from start to finish

In order to do this, Rechat connects to a third party service called SkySlope.

We want to integrate Deal section with Skyslope to give our members ability to do this workflow in Skyslope and have all signed documents in Rechat deals.

Therefore, in order for Rechat to be able to do anything in this section, the user would have to authenticate with his Skyslope credentials.

Authentication

The process of authenticating a user is as follows:

  1. User’s browser will be opened to /brands/:brand/skyslope/auth

  2. User’s browser will be redirected to skyslope

  3. User logs in and authorizes Rechat

  4. User’s browser will be redirected back to Rechat

  5. Control is given back to client (either using Browser’s postMessage mechanism or redirecting him to rechat:// on phones)

  6. Client tries again the initial action

Start admin authentication & ss group creation

Start admin authentication & ss group creation
GET/brands/:brand/skyslope/admin/auth

If another user in this brand had connected his ss account before this api return error.

Example URI

GET /brands/:brand/skyslope/admin/auth
URI Parameters
HideShow
brand
string (required) Example: 25c535b1-449c-4da8-82cc-e7b162999ff4
Response  302

Get Admin Of brand

Get Admin Of brand
GET/brands/:brand/skyslope/admin

Example URI

GET /brands/:brand/skyslope/admin
URI Parameters
HideShow
brand
string (required) Example: 25c535b1-449c-4da8-82cc-e7b162999ff4
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "1986e98f-aa59-4912-9a26-44a7cfc38c86",
    "brand": "25c535b1-449c-4da8-82cc-e7b162999ff4",
    "created_at": "2026-05-15T19:11:51.940Z",
    "admin_credential": "35f027b3-0882-4ee2-b784-65673e4e60f0",
    "updated_at": "2026-05-15T19:11:51.940Z",
    "deleted_at": null,
    "skyslope_group": "dbb5e90b-566d-4c5b-9843-e9367cb812d2",
    "admin_id": "skyslopeId",
    "skyslope_group_id": "123456",
    "user": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "skyslope_email": "[email protected]",
    "type": "skyslope_brand"
  }
}

Start authentication

Start authentication
GET/brands/:brand/skyslope/auth

Example URI

GET /brands/:brand/skyslope/auth
URI Parameters
HideShow
brand
string (required) Example: c1020c6e-6c61-457b-ae79-7cc90c3bae2f
Response  302

Disconnect Skyslope

Disconnect Skyslope
DELETE/users/self/skyslope

Example URI

DELETE /users/self/skyslope
Response  204

Get Skyslope forms

Get Skyslope forms
GET/users/self/skyslope/forms

start (number) number of rows to skip before starting to return rows limit (number) limited number of records libraryIds (text[]) library id

You encounter a 428 error. if skyslope is not connected

Example URI

GET /users/self/skyslope/forms
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": 36095,
      "name": "Agreement Notice to Short Sale Addendum (Short Sale)",
      "libraryId": 14289,
      "attributes": {
        "form-type": "BRBC"
      },
      "source": "Amador County Local Documents - CA",
      "type": "skyslope_form"
    },
    {
      "id": 40144,
      "name": "BRBC Buyer Representation And Broker Compensation Agreement",
      "libraryId": 14289,
      "attributes": {
        "form-type": "BRBC"
      },
      "source": "Amador County Local Documents - CA",
      "type": "skyslope_form"
    }
  ],
  "info": {
    "count": 2,
    "total": 2
  }
}

Get Skyslope libraries

Get Skyslope libraries
GET/users/self/skyslope/libraries

You encounter a 428 error. if skyslope is not connected

Example URI

GET /users/self/skyslope/libraries
Response  200
HideShow
Body
{
          "code": "OK",
          "data": [
            {
              "id": 14289,
              "name": "Amador County Local Documents - CA",
              "regionCodes": [
                "US-CA"
              ]
            }
          ],
          "info": {
            "count": 1,
            "total": 1
          }
        }

if skyslope is not connected, this api return `428`
Response  428
HideShow
Body
{
  "message": "SkySlope needs your permission before Rechat can access your forms and account details. You'll be redirected to SkySlope to review and approve the connection."
}

Create skyslope envelope for a checklist

Create skyslope envelope for a checklist
POST/deals/:id/checklists/:cid/skyslope/envelope

You encounter a 428 error. if skyslope is not connected

if skyslope is not connected, this api return 428 tasks (string[]) array of taskId

Example URI

POST /deals/:id/checklists/:cid/skyslope/envelope
URI Parameters
HideShow
id
string (required) Example: 97e98139-b3cf-4be5-aaf1-e78e3fd3d91b
cid
string (required) Example: ac8eab08-e947-4cc7-8350-bda3e5fbb5ff
Request
HideShow
Body
{
  "tasks": [
    "cfb8ff7f-41a8-4d1b-aecf-65a5e0a05f12"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "success": true,
    "envelope_id": "envelopeId",
    "type": "SKYSLOPE_ENVELOPE",
    "taskSyncErrors": {},
    "contactSyncErrors": {}
  }
}

Generated by aglio on 15 May 2026