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/'}