Create Tos Link

Mint a hosted-acceptance link.

Untargeted it precedes the customer, pass the signed_tos_id its acceptance yields into POST /api/customers. Pre-targeting a customer_id serves RE-acceptance after a terms-version bump (creation already required an agreement, so the customer exists): acceptance binds straight onto that customer with no follow-up call, the hosted twin of tos_acceptance on PATCH /api/customers/{id}, and refused the same way (409) when that customer is already on the current version.

curl -X POST "https://sandbox.rasto.co/api/tos_links" \
  -H "Content-Type: application/json" \
  -H "Api-Key: example_string" \
  -H "Api-Version: example_string" \
  -H "Idempotency-Key: example_string" \
  -H "Api-Key: YOUR_API_KEY" \
  -d '{
  "redirect_url": "example_string",
  "customer_id": "example_string"
}'

import requests
import json

url = "https://sandbox.rasto.co/api/tos_links"
headers = {
  "Content-Type": "application/json",
  "Api-Key": "YOUR_API_KEY",
  "Api-Version": "example_string",
  "Idempotency-Key": "example_string"
}
data = {
  "redirect_url": "example_string",
  "customer_id": "example_string"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://sandbox.rasto.co/api/tos_links", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "Api-Key": "YOUR_API_KEY",
  "Api-Version": "example_string",
  "Idempotency-Key": "example_string"
},
  body: JSON.stringify({
  "redirect_url": "example_string",
  "customer_id": "example_string"
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "redirect_url": "example_string",
  "customer_id": "example_string"
}`)

    req, err := http.NewRequest("POST", "https://sandbox.rasto.co/api/tos_links", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Api-Key", "example_string")
    req.Header.Set("Api-Version", "example_string")
    req.Header.Set("Idempotency-Key", "example_string")
    req.Header.Set("Api-Key", "YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://sandbox.rasto.co/api/tos_links')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Api-Key'] = 'example_string'
request['Api-Version'] = 'example_string'
request['Idempotency-Key'] = 'example_string'
request['Api-Key'] = 'YOUR_API_KEY'
request.body = '{
  "redirect_url": "example_string",
  "customer_id": "example_string"
}'

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

{
  "id": "example_string",
  "object": "example_string",
  "url": "example_string",
  "tos_version": "example_string",
  "status": "example_string",
  "signed_tos_id": "example_string",
  "customer_id": "example_string",
  "created_at": "2024-12-25T10:00:00Z"
}

{
  "error": "Unprocessable Entity",
  "message": "The request was well-formed but contains semantic errors",
  "code": 422,
  "details": [
    {
      "field": "password",
      "message": "Password must be at least 8 characters long"
    }
  ]
}

POST

/api/tos_links

POST

Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: Api-Key)

Api-Keystring

Required

API key (sent in header)

Content-Typestring

Required

The media type of the request body

Options: application/json

The /api contract to serve this request under, as an ISO date. Omit to use the default (2026-08-01), omitting it always keeps today's behaviour, so a future breaking change cannot move you. Supported: 2026-08-01.

header

Idempotency-Keystring

Required

Unique per request; a retry with the same key replays the stored response byte-for-byte.

redirect_urlstring

customer_idstring