Create resolution link

Create a resolution link for the specified account. Resolution links are temporary, secure links sent to merchants to resolve account requirements such as KYC verification or document uploads. Only one active resolution link is allowed per connected account.

To access this endpoint using an access token you'll need to specify the /accounts/{accountID}/profile.write, /accounts/{accountID}/representatives.write and /accounts/{accountID}/files.write scopes.

Request

POST

/accounts/{accountID}/resolution-links

Example Requests

cURL

curl -X POST "https://api.moov.io/accounts/{accountID}/resolution-links" \
  -H "Authorization: Bearer {token}" \
  -H "X-Moov-Version: v2026.04.00" \
  -d '{
  "recipient": {
    "phone": {
      "number": "5555555555",
      "countryCode": "1"
    }
  }
}'

TypeScript

import { Moov } from "@moovio/sdk";

const moov = new Moov({
  security: {
    username: "",
    password: "",
  },
});

async function run() {
  const result = await moov.resolutionLinks.create({
    accountID: "<id>",
    createResolutionLink: {
      recipient: {
        phone: {
          number: "5555555555",
          countryCode: "1",
        },
      },
    },
  });

console.log(result);
}

run();

PHP

declare(strict_types=1);

require 'vendor/autoload.php';

use Moov\