Skip to main content
POST
/
card
cURL
curl --request POST \
  --url https://secure.development.knotapi.com/card \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user": {
    "name": {
      "first_name": "Ada",
      "last_name": "Lovelace"
    },
    "phone_number": "+11234567890",
    "address": {
      "street": "100 Main Street",
      "city": "New York",
      "region": "NY",
      "postal_code": "12345",
      "country": "US",
      "street2": "#100"
    }
  },
  "card": {
    "number": "4242424242424242",
    "expiration": "08/2025",
    "cvv": "123"
  },
  "task_id": "123456"
}
'
{
  "message": "Success"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

The input parameters required for switching a card.

​
user
object
required
​
card
object
required
​
task_id
string
required

task_id value provided in the AUTHENTICATED webhook.

Example:

"123456"

Response

Successful request.

​
message
string

Success message.

Example:

"Success"