Link an existing account via SSO

curl --request POST \
  --url https://app.sure.am/api/v1/auth/sso_link \
  --header 'Content-Type: application/json' \
  --data '
{
  "linking_code": "<string>",
  "email": "jsmith@example.com",
  "password": "<string>"
}
'

import requests

url = "https://app.sure.am/api/v1/auth/sso_link"

payload = {
    "linking_code": "<string>",
    "email": "jsmith@example.com",
    "password": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({linking_code: '<string>', email: 'jsmith@example.com', password: '<string>'})
};

fetch('https://app.sure.am/api/v1/auth/sso_link', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sure.am/api/v1/auth/sso_link",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'linking_code' => '<string>',
    'email' => 'jsmith@example.com',
    'password' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sure.am/api/v1/auth/sso_link"

	payload := strings.NewReader("{\n  \"linking_code\": \"<string>\",\n  \"email\": \"jsmith@example.com\",\n  \"password\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sure.am/api/v1/auth/sso_link")
  .header("Content-Type", "application/json")
  .body("{\n  \"linking_code\": \"<string>\",\n  \"email\": \"jsmith@example.com\",\n  \"password\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sure.am/api/v1/auth/sso_link")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linking_code\": \"<string>\",\n  \"email\": \"jsmith@example.com\",\n  \"password\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "access_token": "<string>",
  "refresh_token": "<string>",
  "token_type": "<string>",
  "expires_in": 123,
  "created_at": 123,
  "user": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "ui_layout": "dashboard",
    "ai_enabled": true
  }
}

{
  "error": "<string>",
  "message": "<string>",
  "details": [
    "<string>"
  ],
  "errors": [
    "<string>"
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "details": [
    "<string>"
  ],
  "errors": [
    "<string>"
  ]
}

POST

api

auth

sso_link

Link an existing account via SSO

curl --request POST \
  --url https://app.sure.am/api/v1/auth/sso_link \
  --header 'Content-Type: application/json' \
  --data '
{
  "linking_code": "<string>",
  "email": "jsmith@example.com",
  "password": "<string>"
}
'

import requests

url = "https://app.sure.am/api/v1/auth/sso_link"

payload = {
    "linking_code": "<string>",
    "email": "jsmith@example.com",
    "password": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({linking_code: '<string>', email: 'jsmith@example.com', password: '<string>'})
};

fetch('https://app.sure.am/api/v1/auth/sso_link', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sure.am/api/v1/auth/sso_link",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'linking_code' => '<string>',
    'email' => 'jsmith@example.com',
    'password' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sure.am/api/v1/auth/sso_link"

	payload := strings.NewReader("{\n  \"linking_code\": \"<string>\",\n  \"email\": \"jsmith@example.com\",\n  \"password\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sure.am/api/v1/auth/sso_link")
  .header("Content-Type", "application/json")
  .body("{\n  \"linking_code\": \"<string>\",\n  \"email\": \"jsmith@example.com\",\n  \"password\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sure.am/api/v1/auth/sso_link")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linking_code\": \"<string>\",\n  \"email\": \"jsmith@example.com\",\n  \"password\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "access_token": "<string>",
  "refresh_token": "<string>",
  "token_type": "<string>",
  "expires_in": 123,
  "created_at": 123,
  "user": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "ui_layout": "dashboard",
    "ai_enabled": true
  }
}

{
  "error": "<string>",
  "message": "<string>",
  "details": [
    "<string>"
  ],
  "errors": [
    "<string>"
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "details": [
    "<string>"
  ],
  "errors": [
    "<string>"
  ]
}

Body

application/json

linking_code

string

required

One-time linking code from mobile SSO onboarding redirect

string<email>

required

Email of the existing account to link

password

string

required

Password for the existing account

Response

account linked and tokens issued

access_token

string

refresh_token

string

token_type

string

expires_in

integer

created_at

integer

user

object

Show child attributes

⌘I

Auth

Accounts

Balance Sheet

Balances

Budget Categories

Budgets

Categories

Chats

Family Exports

Family Settings

Holdings

Import Sessions

Imports

Merchants

Provider Connections

Recurring Transactions

Rejected Transfers

Rule Runs

Rules

Securities

Security Prices

Sync

Tags

Trades

Transactions

Transfers

Valuations

Users

Link an existing account via SSO

Body

Response