curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-H 'Profile-Key: PROFILE_KEY' \
-d '{"expiresIn": 60}' \
-X POST https://api.ayrshare.com/api/profiles/link-sessions

const API_KEY = "API_KEY";
const PROFILE_KEY = "PROFILE_KEY";

fetch("https://api.ayrshare.com/api/profiles/link-sessions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${API_KEY}`,
    "Profile-Key": PROFILE_KEY,
  },
  body: JSON.stringify({ expiresIn: 60 }),
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

payload = {'expiresIn': 60}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY',
        'Profile-Key': 'PROFILE_KEY'}

response = requests.post('https://api.ayrshare.com/api/profiles/link-sessions',
                         json=payload, headers=headers)
print(response.json())

<?php
require 'vendor/autoload.php';    // Composer auto-loader using Guzzle. See .../guzzlephp.org/en/stable/overview.html

$client = new GuzzleHttp\Client();
$res = $client->request(
    'POST',
    'https://api.ayrshare.com/api/profiles/link-sessions',
    [
        'headers' => [
            'Content-Type'  => 'application/json',
            'Authorization' => 'Bearer API_KEY',
            'Profile-Key'   => 'PROFILE_KEY'
        ],
        'json' => [
            'expiresIn' => 60,
        ]
    ]
);

echo json_encode(json_decode($res->getBody()), JSON_PRETTY_PRINT);

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

namespace CreateLinkSession_csharp
{
  class CreateLinkSession
  {
      static async Task Main(string[] args)
      {
          string API_KEY = "API_KEY";
          string PROFILE_KEY = "PROFILE_KEY";
          string url = "https://api.ayrshare.com/api/profiles/link-sessions";

          try
          {
              using (var client = new HttpClient())
              {
                  client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
                  client.DefaultRequestHeaders.Add("Profile-Key", PROFILE_KEY);

                  var sendData = new { expiresIn = 60 };
                  string jsonData = JsonConvert.SerializeObject(sendData);
                  var content = new StringContent(jsonData, Encoding.UTF8, "application/json");

                  HttpResponseMessage response = await client.PostAsync(url, content);
                  response.EnsureSuccessStatusCode();

                  string responseBody = await response.Content.ReadAsStringAsync();
                  Console.WriteLine(responseBody);
              }
          }
          catch (HttpRequestException e)
          {
              Console.WriteLine($"HTTP request error: {e.Message}");
          }
      }
  }
}

{
    "status": "success",
    "sessionId": "c7a2434e72e91bde27579efde0fd6dd0b74ceee29a471fd368407f273708c2e8",  // Identifier for this link. Use it with Get and Revoke a Link Session.
    "url": "https://profile.ayrshare.com?session=ayr_ls_kJ8mQ2vX9pLnR4tYwZ6aBcD1eFgH3iJkLmN0oPqRsTu&domain=YOUR_DOMAIN",  // Send this to your user exactly as returned. The token exists only in here.
    "expiresAt": "2026-09-02T08:03:26.838Z",  // When the link stops working, as an ISO 8601 timestamp.
    "emailSent": false,  // Whether the connect-accounts email was sent. false with no emailError means no email was requested.
    "title": "Acme Client"  // The User Profile's title. Omitted when the profile has none.
}

{
    "status": "success",
    "sessionId": "c7a2434e72e91bde27579efde0fd6dd0b74ceee29a471fd368407f273708c2e8",
    "url": "https://profile.ayrshare.com?session=ayr_ls_kJ8mQ2vX9pLnR4tYwZ6aBcD1eFgH3iJkLmN0oPqRsTu&domain=YOUR_DOMAIN",  // Still valid. Send it to your user yourself.
    "expiresAt": "2026-09-02T08:03:26.838Z",
    "emailSent": false,
    "emailError": {  // Only present when an email was requested and could not be sent.
        "code": 333,
        "message": "Email failed to send. Please confirm a valid email was provided."
    },
    "title": "Acme Client"
}

{
    "status": "success",
    "sessionId": "c7a2434e72e91bde27579efde0fd6dd0b74ceee29a471fd368407f273708c2e8",
    "url": "https://profile.ayrshare.com/connect?session=ayr_ls_kJ8mQ2vX9pLnR4tYwZ6aBcD1eFgH3iJkLmN0oPqRsTu",  // Open this in a popup. One network, no domain parameter.
    "expiresAt": "2026-09-02T08:03:26.838Z",
    "emailSent": false,
    "title": "Acme Client"
}

{
    "status": "success",
    "sessionId": "c7a2434e72e91bde27579efde0fd6dd0b74ceee29a471fd368407f273708c2e8",
    "token": "ayr_ls_kJ8mQ2vX9pLnR4tYwZ6aBcD1eFgH3iJkLmN0oPqRsTu",  // No url: this shape returns the bare token instead. Treat it like a password.
    "expiresAt": "2026-09-02T08:03:26.838Z",
    "emailSent": false,  // Always false here - email needs a link to send, so it returns code: 510.
    "title": "Acme Client"
}

{
  "action": "link session",
  "status": "error",
  "code": 504,
  "message": "Connect mode requires the Max Pack. Activate it on your Account page: https://app.ayrshare.com/account"
}

{
  "action": "JWT",
  "status": "error",
  "code": 188,
  "message": "Missing or incorrect privateKey, profileKey, domain, email 'to', or expiresIn fields."
}

{
  "action": "JWT",
  "status": "error",
  "code": 189,
  "message": "Error generating JWT. Check the sent parameters.",
  "details": "Missing or incorrect domain."
}

{
  "action": "authorization",
  "status": "error",
  "code": 340,
  "message": "Max Pack is required. Please go to your Account page in the Ayrshare Dashboard to activate the Max Pack.",
  "details": "email and expiresIn parameters are only available on the Max Pack."
}