Create addressbook

Create a CardDAV compatible addressbook

  • HTTP Method: POST
  • URL: https://example.domain.tld/api/v1/contacts/
  • Require authentication: Yes
  • Permission level required: MailUser

Request parameters

Parameter Type Description Required
friendly_name str Name (identifier) for addressbook Required

Response parameters

Parameter Type Description
friendly_name str Name (identifier) of addressbook
status str Status
url str URL of CardDAV addressbook

Example request (Python)

import requests
import json
from pprint import pprint

url = "https://example.domain.tld/api/v1/contacts/"
data = {
"friendly_name" : "Office"
}
r = requests.post(url, json=data, auth=("ab@vonmail.com","long-auth_token-here"))
try:
    pprint(r.json())
except: 
    print(r.text)

Example response (JSON)

{'friendly_name': 'Office',
 'status': 'generating',
 'url': 'https://example.domain.tld/radicale/ab@vonmail.com/be9ae280-45e8-4f81-acc3-c5a7ce1fb428/'}