Create Customer
curl --request POST \
  --url https://api.revolv3.com/api/Customers \
  --header 'Content-Type: application/json-patch+json' \
  --data '{
  "merchantCustomerRefId": null,
  "firstName": "John",
  "lastName": "Doe",
  "email": null,
  "billingAddresses": [
    {
      "addressId": null,
      "addressLine1": "100 Main Street",
      "addressLine2": "",
      "city": "Santa Ana",
      "state": "CA",
      "postalCode": "90000",
      "phoneNumber": null,
      "email": null,
      "country": "US"
    }
  ],
  "shippingAddresses": [
    {
      "addressId": null,
      "addressLine1": "101 First Street",
      "addressLine2": "",
      "city": "Costa Mesa",
      "state": "CA",
      "postalCode": "90001",
      "phoneNumber": null,
      "email": null,
      "country": "US"
    }
  ],
  "subscriptions": [
    {
      "paymentMethods": [
        {
          "paymentMethodTypes": [
            1
          ],
          "priority": 0,
          "taxAmount": null,
          "originalNetworkTransactionId": null,
          "billingAddress": {
            "addressId": null,
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Irvine",
            "state": "CA",
            "postalCode": "92602",
            "phoneNumber": null,
            "email": null,
            "country": "US"
          },
          "creditCard": {
            "paymentAccountNumber": "4111111111111111",
            "expirationDate": "1025",
            "securityCode": null,
            "networkToken": null,
            "processingMethodType": 5
          },
          "ach": null,
          "googlePay": null,
          "applePay": null,
          "merchantPaymentMethodRefId": null,
          "billingFirstName": "John",
          "billingLastName": "Doe",
          "billingFullName": null
        }
      ],
      "existingPaymentMethod": null,
      "merchantSubscriptionRefId": "1234-5678-9101",
      "billingFrequency": {
        "intervalType": 1,
        "intervalCount": 1
      },
      "subscriptionStatusType": "current",
      "subscriptionCancelType": "EndOfCycle",
      "startDate": "2025-09-08T00:00:00Z",
      "trialDuration": 0,
      "trialDurationType": 1,
      "taxAddress": {
        "addressId": null,
        "addressLine1": "101 Update Street",
        "addressLine2": "",
        "city": "Irvine",
        "state": "CA",
        "postalCode": "92602",
        "phoneNumber": null,
        "email": null,
        "country": "US"
      },
      "includeRawProcessorResponse": false,
      "customer": null,
      "subscriptionBillingPlans": [
        {
          "name": "Billing Plan 1",
          "value": 10.99,
          "cycleCount": -1,
          "valueType": "Standard",
          "startCycleDelay": 0
        },
        {
          "name": "Billing Plan 2",
          "value": 14.99,
          "cycleCount": 12,
          "valueType": "Standard",
          "startCycleDelay": 1
        }
      ],
      "recycleImmediatePayment": false,
      "currency": 1
    }
  ]
}'
{
  "customerId": 1,
  "merchantCustomerRefId": "1234-5678-9101",
  "firstName": "John",
  "lastName": "Doe",
  "billingAddresses": [
    {
      "addressId": 1,
      "addressLine1": "100 Main Street",
      "addressLine2": null,
      "city": "Santa Ana",
      "state": "CA",
      "postalCode": "90000",
      "phoneNumber": null,
      "email": null,
      "country": "US"
    }
  ],
  "shippingAddresses": [
    {
      "addressId": 2,
      "addressLine1": "101 First Street",
      "addressLine2": "",
      "city": "Costa Mesa",
      "state": "CA",
      "postalCode": "90001",
      "phoneNumber": null,
      "email": null,
      "country": "US"
    }
  ],
  "taxAddresses": [],
  "subscriptions": [
    {
      "subscriptionId": 1,
      "customerId": 1,
      "merchantSubscriptionRefId": "1234-5678-9101",
      "networkTransactionId": null,
      "billingIntervalType": "Days",
      "billingIntervalCount": 1,
      "subscriptionStatusType": "current",
      "subscriptionCancelType": null,
      "initialBillDate": "08-Sep-25",
      "nextBillDate": "09-Sep-25",
      "taxAddress": null,
      "paymentMethodIds": null,
      "cancelledAt": null,
      "billingPlans": [
        {
          "subscriptionBillingPlanId": 1,
          "subscriptionId": 0,
          "name": "Billing Plan 1",
          "value": 10.99,
          "startDate": "08-Sep-25",
          "cyclesRemaining": -1,
          "cycleCount": 0,
          "valueType": "Standard"
        },
        {
          "subscriptionBillingPlanId": 2,
          "subscriptionId": 0,
          "name": "Billing Plan 2",
          "value": 14.99,
          "startDate": "09-Sep-25",
          "cyclesRemaining": 12,
          "cycleCount": 0,
          "valueType": "Standard"
        }
      ],
      "message": null,
      "paymentProcessor": null,
      "processorMerchantId": null,
      "processorRawResponse": null,
      "currency": null
    }
  ]
}

Body

Response

Created

The response is of type object.