RArazorpay
X Contacts

Create a contact

Create a payout recipient contact. Returns existing contact if all identifying fields (name, email, contact, type) match an existing record.

post/contacts

Request

  • Base URL
    https://api.razorpay.com/v1
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization codehttps://mcp.razorpay.com/authorize
      Client credentials
      Token URLhttps://mcp.razorpay.com/token
      Scopesread_only
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Request body

namestring required
emailstring email
contactstring
type'vendor' | 'customer' | 'employee' | 'self'
reference_idstring
notesobject

Response

Contact created

idstring

Contact ID (cont_*)

entity'contact'
namestring
emailstring email
contactstring

Phone number

type'vendor' | 'customer' | 'employee' | 'self'

Built-in types only via API; custom types must be created on Dashboard first

reference_idstring

External reference (must be unique per merchant)

batch_idstring
activeboolean
notesobject
created_atinteger

Unix timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.