Fresh 2026

Linked Accounts

The /linked-accounts endpoint. Query which integrations a customer has connected and what operations (read, write, delete) each supports.

---

Overview

The Linked Accounts endpoint returns a list of LinkedAccount objects. Each LinkedAccount contains, among other things, the following information about the models and actions available for that account:

• integration: Includes name, categories, image, square image, and primary color. You can use this information to build an adaptive UI that accurately reflects the integration your user has chosen to link.
• passthrough_available: defines whether you are able to use the Passthrough endpoint to make custom requests of any kind to the given API. This value is almost always true.
• available_model_operations: For the provided integration, we return each supported data model, the supported operations (FETCH/CREATE/UPDATE/DELETE), the supported fields, and the required fields to create an instance of that model.

---

Request

The request will return all linked accounts regardless of which category is passed into the URL.

You will also want to include an Authorization header that includes your Merge API key - see the Authentication section for more details.

GET https://api.merge.dev/api/ats/linked-accounts

---

{
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
  "previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ",
  "results": [
    {
      "id": "e59b1821-f85c-4e28-a6b3-1804156f3563",
      "category": "hris",
      "status": "INCOMPLETE",
      "status_detail": "Invalid login credentials",
      "end_user_origin_id": "3ac95cde-6c7f-4eef-afec-be710b42308d",
      "end_user_organization_name": "Foo Bar, LLC",
      "end_user_email_address": "hradmin@foobar.dev",
      "subdomain": "foobar",
      "webhook_listener_url": "https://api.merge.dev/api/integrations/webhook-listener/7fc3mee0UW8ecV4",
      "is_duplicate": true,
      "integration": {
        "name": "SAP SuccessFactors",
        "categories": [
          "hris",
          "ats"
        ],
        "image": "https://cdn.merge.dev/SuccessFactors_Logo.png",
        "square_image": "https://cdn.merge.dev/SuccessFactors_Square_Logo.jpg",
        "color": "#F6A704",
        "slug": "sap-successfactors",
        "passthrough_available": true,
        "available_model_operations": [
          {
            "model_name": "Candidate",
            "available_operations": [
              "FETCH",
              "CREATE"
            ],
            "required_post_parameters": [
              "remote_user_id"
            ],
            "supported_fields": [
              "first_name",
              "last_name",
              "company",
              "title"
            ]
          }
        ]
      },
      "account_type": "PRODUCTION",
      "completed_at": "2024-08-26T20:11:19.277118Z",
      "integration_specific_fields": {
        "integration_specific_field": "Varies by platform"
      }
    }
  ]
}