{"id":5062,"date":"2025-02-05T13:25:22","date_gmt":"2025-02-05T19:25:22","guid":{"rendered":"http:\/\/www.multitech.net\/developer\/?page_id=5062"},"modified":"2025-02-05T13:27:42","modified_gmt":"2025-02-05T19:27:42","slug":"creating-a-new-group","status":"publish","type":"page","link":"https:\/\/www.multitech.net\/developer\/software\/faxfinder\/web-services-api\/contact-and-group-apis\/creating-a-new-group\/","title":{"rendered":"Creating a New Group"},"content":{"rendered":"

Requires FaxFinder 3.0.4 or higher.<\/em><\/p>\n\n\n\n\n\n
\n

HTTP Request Line<\/p>\n<\/td>\n

\n

POST \/ffws\/v1\/contact_groups\/admin HTTP\/1.1<\/p>\n<\/td>\n<\/tr>\n

\n

HTTP Response Status Codes<\/p>\n<\/td>\n

\n

200 OK<\/p>\n<\/td>\n

\n

Created new group.<\/p>\n<\/td>\n<\/tr>\n

\n

403 Forbidden<\/p>\n<\/td>\n

\n

Authenticated user does not have permission to change data associated with username.<\/p>\n<\/td>\n<\/tr>\n

\n

400 Bad Request<\/p>\n<\/td>\n

\n

The provided XML is not valid.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Example<\/h4>\n
\r\nPOST \/ffws\/v1\/contact_groups\/admin HTTP\/1.1\r\ncontent-type: application\/xml\r\nauthorization: Basic YWRtaW46YWRtaW4=\r\n<?xml version=\u201d1.0\u201d encoding=\u201dUTF-8\u201d?>\r\n<contact_group>\r\n\t<name>New Group from API<\/name>\r\n\t<description>Can I create one from the API<\/description>\r\n\t<contact>https:\/\/dot3\/ffws\/v1\/contacts\/admin\/23<\/contact>\r\n\t<contact>https:\/\/dot3\/ffws\/v1\/contacts\/admin\/24<\/contact>\r\n\t<contact>https:\/\/dot3\/ffws\/v1\/contacts\/admin\/25<\/contact>\r\n\t<contact>https:\/\/dot3\/ffws\/v1\/contacts\/admin\/26<\/contact>\r\n<\/contact_group>\r\n----------------------\r\n<?xml version=\u201d1.0\u201d encoding=\u201dUTF-8\u201d?>\r\n<response>\r\n\t<message>Created<\/message>\r\n\t<contact_group>\r\n\t\t<contact_group_url>https:\/\/dot3\/ffws\/v1\/contact_groups\/admin\/14<\/contact_group_url>\r\n\t\t<name>New Group from API<\/name>\r\n\t\t<description>Can I create one from the API<\/description>\r\n\t\t<contact>https:\/\/dot3\/ffws\/v1\/contacts\/admin\/23<\/contact>\r\n\t\t<contact>https:\/\/dot3\/ffws\/v1\/contacts\/admin\/24<\/contact>\r\n\t\t<contact>https:\/\/dot3\/ffws\/v1\/contacts\/admin\/25<\/contact>\r\n\t\t<contact>https:\/\/dot3\/ffws\/v1\/contacts\/admin\/26<\/contact>\r\n\t<\/contact_group>\r\n<\/response>\r\n\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"
Requires FaxFinder 3.0.4 or higher. HTTP Request Line POST \/ffws\/v1\/contact_groups\/admin HTTP\/1.1 HTTP Response Status Codes 200 OK Created new group. 403 Forbidden Authenticated user does not have permission to change data associated with username. 400 Bad Request The provided XML is not valid. Example POST \/ffws\/v1\/contact_groups\/admin HTTP\/1.1 content-type: application\/xml authorization: Basic YWRtaW46YWRtaW4= <?xml version=\u201d1.0\u201d encoding=\u201dUTF-8\u201d?> […]<\/p>\n","protected":false},"author":537,"featured_media":0,"parent":5406,"menu_order":24,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"footnotes":""},"class_list":["post-5062","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages\/5062","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/users\/537"}],"replies":[{"embeddable":true,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/comments?post=5062"}],"version-history":[{"count":14,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages\/5062\/revisions"}],"predecessor-version":[{"id":5674,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages\/5062\/revisions\/5674"}],"up":[{"embeddable":true,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages\/5406"}],"wp:attachment":[{"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/media?parent=5062"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}