Create a Card

Create a digital card directly in your user account.

If you want to create a digital card and assign it to a space, please proceed to the 'Business Manager / Space' -> 'Create a Card' tab.

The first name and last name are directly taken from the logged-in user. The following BODY parameters must be specified as required fields:

{
    "focus": "contact",
    "position": "CTO",
    "phone": "165655650",
    "phone_prefix": "+43",
    "address": {
        "address_line1": null,
        "address_line2": null,
        "zipcode": null,
        "city": null,
        "country": "AT"
    },
    "addAddress": false,
    "website": "https://becard.me"
}

POST /v1/cards

200: OK

{
    "uuid": "z5C1YXXXX",
    "public": null,
    "username": "jon-doe-XXXX",
    "firstName": "Jon",
    "lastName": "Doe",
    "prefix": null,
    "suffix": null,
    "display_name": "Jon Doe",
    "organisation": null,
    "position": "CTO",
    "department": null,
    "focus": "contact",
    "template": null,
    "color": null,
    "visible": 0,
    "is_premium": false,
    "is_business": false,
    "space": null,
    "redirection": null,
    "video_frame": null,
    "short_description": null,
    "assets": {
        "avatar": {
            "uuid": null,
            "src": "https://cdn.becard.me/default/card_v1.jpg"
        },
        "header": null,
        "logo": null
    },
    "contacts": [
        {
            "uuid": "zUiuYQveXXXX",
            "type": "phone",
            "category": "default",
            "pos": null,
            "name": null,
            "value": "165655650",
            "prefix": "+43",
            "default": 1
        }
    ],
    "addresses": null,
    "social_media": [],
    "settings": {
        "protection": {
            "enable_pin": false
        },
        "layout": {
            "save_avatar": true,
            "show_avatar": true,
            "show_logo": true,
            "show_icon": false,
            "show_header": true,
            "show_organisation": true,
            "show_address": true,
            "show_vcf_link": true,
            "show_login_button": true,
            "show_becard_logo": true,
            "enable_backgrounds": false,
            "enable_blur": false,
            "enable_dark_mode": false,
            "enable_favicons": false
        },
        "services": {
            "enable_contact_book": false,
            "enable_multi_language": false,
            "enable_social_media": true,
            "enable_wallets": true,
            "enable_pushNotifications": false,
            "enable_pushNotifications_fields": {
                "pushNotification_id": "HtLWN3tMXXXXX"
            },
            "enable_newsletter": false,
            "enable_newsletter_fields": {
                "email": true,
                "name": true,
                "phone": false
            },
            "enable_qrCode": true,
            "enable_affiliate": false,
            "enable_affiliate_fields": {
                "code": null,
                "link": null
            }
        }
    },
    "connected_cards": 0,
    "access_pin": null,
    "created_at": "2024-02-06T17:49:34.000000Z",
    "updated_at": "2024-02-06T17:49:34.000000Z"
}