To create a bookmark, send an Atom entry document containing the new bookmark to the bookmarks feed.
See Authenticating requests
for information about how to authenticate the request.
Table 1. Atom API request details
|POST||bookmark feed||Found in the href attribute of the <collection> element in the user's service document. ||bookmark|
Provide a bookmark Atom entry document.
The content type of the Atom entry document must be application/atom+xml
An Atom entry document containing the new bookmark entry.
Returned HTTP headers
HTTP/1.1 201 Created
Indicates that the bookmark was successfully created. If an error occurs, this header contains one of the error codes.Location: url
Link to edit_url of the new bookmark entry. You can use the web address specified here to subsequently retrieve and update the bookmark entry.Error codes
- HTTP/1.1 400 Bad Request
- HTTP/1.1 403 Forbidden
Parent topic: Working with bookmarks programmatically