Contact Data

If you want to update the contact details and address, it's important to always provide all parameters. If you omit one, it will be automatically deleted from the system.

// JSON POST Example:
{
    "contacts": [
        {
            "uuid": "XXXXXXX",
            "type": "mobile",
            "category": "default",
            "pos": null,
            "name": null,
            "value": "-960-130-005",
            "prefix": "+43",
            "default": 0
        },
        {
            "uuid": "XXXXXXX",
            "type": "phone",
            "category": "default",
            "pos": null,
            "name": null,
            "value": "-960-130-004",
            "prefix": "+34",
            "default": 1
        },
        {
            "uuid": "XXXXXXX",
            "type": "email",
            "category": "default",
            "pos": null,
            "name": null,
            "value": "[e-mail]",
            "prefix": null,
            "default": 0
        },
        {
            "uuid": null",
            "pos": null,
            "type": "address",
            "category": "default",
            "name": null,
            "value": {
                "pos": null,
                "zipcode": "28036",
                "city": "Madrid",
                "address_line1": "Av. Concha Espina 1",
                "address_line2": null,
                "space_address": false,
                "space_default": null,
                "country": {
                    "iso2": "ES",
                }
            },
            "prefix": null,
            "default": 0
        },
        {
            "uuid": null,
            "type": "website",
            "category": "default",
            "pos": null,
            "name": "Visit my Website",
            "value": "https://zara.es",
            "prefix": null,
            "default": 0
        }
    ]
}

POST /v1/cards/{CARD_UUID}/contacts

The BODY parameters should be passed in an array named 'contacts.' Refer to the JSON POST example above for a better understanding.

Request Body

Name	Type	Description
uuid	string	nullable
type*	enum	mobile, phone, fax, website, address
category*	string	default
name	string	nullable
value	string/array	nullable
prefix	string	nullable
default*	boolean	0

200: OK

How to handle connections to space addresses?

You have the option to link an address from the locations in your space directly to this digital card instead of providing the complete address. To do this, simply provide the UUID of the space address and set the parameter in the value array 'space_address' to true. Here's an example:

    ...
        {
            "uuid": "DSWRERTRSXXXXX00", // <- SET THE SPACE ADDRESS UUID
            "pos": null,
            "type": "address",
            "category": "default",
            "name": null,
            "value": {
                "pos": null,
                "zipcode": null",
                "city": null,
                "address_line1": null,
                "address_line2": null,
                "space_address": true, // <- SET TO TRUE
                "space_default": null,
                "country": {
                    "iso2": "ES",
                }
            },
            "prefix": null,
            "default": 0
        },
    ...    

The advantage of linking to space addresses is that if you change the address in your space, this change will be reflected on all digital business cards linked to your space address.