---
title: "POST /tenants/{tenantId}/merchants/{merchantId}/services"
method: POST
path: "/tenants/{tenantId}/merchants/{merchantId}/services"
tags: ["Tenants"]
---

# POST /tenants/{tenantId}/merchants/{merchantId}/services

`POST /tenants/{tenantId}/merchants/{merchantId}/services`

## Request

- Base URL: `https://api.basistheory.com`
- URL: `https://api.basistheory.com/tenants/{tenantId}/merchants/{merchantId}/services`
- Auth: API key in header `BT-API-KEY`

## Path parameters

- `tenantId` string, uuid, required
- `merchantId` string, uuid, required

## Request body

- ServiceOnboardingRequest
  - `account_updater` string[], nullable
  - `network_token` string[], nullable
  - `agentic_commerce` string[], nullable
  - `card_network_info` CardNetworkInfo
    - `visa` VisaConfig
      - `acquirer_bin` string, nullable
      - `card_acceptor_id_caid` string, nullable
    - `mastercard` MastercardConfig
      - `merchant_id_mid` string, nullable
    - `amex` AmexConfig
      - `se_number` string, nullable
    - `discover` DiscoverConfig
      - `merchant_id_mid` string, nullable

## Response `200`

OK

- TenantMerchant
  - `id` string, uuid
  - `tenant_id` string, uuid
  - `name` string, nullable
  - `details` MerchantDetails
    - `merchant` MerchantInfo
      - `full_legal_name` string, nullable
      - `doing_business_as` string, nullable
      - `parent_company_name` string, nullable
      - `website_url` string, nullable
      - `category_code_mcc` string, nullable
      - `descriptor` string, nullable
      - `business_description` string, nullable
      - `registration` MerchantRegistration
        - `registration_type` string, nullable
        - `registration_id` string, nullable
        - `vat_id` string, nullable
      - `contact` MerchantContact
        - `name` string, nullable
        - `title` string, nullable
        - `phone_number` string, nullable
        - `email` string, nullable
      - `address` MerchantAddress
        - `street_1` string, nullable
        - `street_2` string, nullable
        - `city` string, nullable
        - `state_province` string, nullable
        - `postal_code` string, nullable
        - `country` string, nullable
    - `card_network_info` CardNetworkInfo
      - `visa` VisaConfig
        - `acquirer_bin` string, nullable
        - `card_acceptor_id_caid` string, nullable
      - `mastercard` MastercardConfig
        - `merchant_id_mid` string, nullable
      - `amex` AmexConfig
        - `se_number` string, nullable
      - `discover` DiscoverConfig
        - `merchant_id_mid` string, nullable
  - `services` MerchantServices
    - `account_updater` ServiceStatus
      - `status` string, nullable
      - `providers` string[], nullable
      - `card_network_status` CardNetworkStatus
        - `visa` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `mastercard` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `amex` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `discover` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
    - `network_token` ServiceStatus
      - `status` string, nullable
      - `providers` string[], nullable
      - `card_network_status` CardNetworkStatus
        - `visa` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `mastercard` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `amex` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `discover` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
    - `agentic_commerce` ServiceStatus
      - `status` string, nullable
      - `providers` string[], nullable
      - `card_network_status` CardNetworkStatus
        - `visa` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `mastercard` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `amex` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
        - `discover` NetworkStatusDetail
          - `status` string, nullable
          - `status_reason_code` string, nullable
          - `status_reason` string, nullable
          - `status_reason_label` string, nullable
  - `created_by` string, uuid, nullable
  - `created_at` string, date-time, nullable
  - `modified_by` string, uuid, nullable
  - `modified_at` string, date-time, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict

## Changes

- **2026-08-08** `88754703a861`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/basistheory/apis/basis-theory-api/changes/tenants/:tenantId/merchants/:merchantId/services/post.md)

---

[API](https://skmtc.dev/basistheory/apis/basis-theory-api.md) - [All operations](https://skmtc.dev/basistheory/apis/basis-theory-api/llms.txt) - [OpenAPI document](https://skmtc.dev/basistheory/apis/basis-theory-api/revisions/05fab7a622ac?raw)