Creating a New Group

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

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
POST /ffws/v1/contact_groups/admin HTTP/1.1
content-type: application/xml
authorization: Basic YWRtaW46YWRtaW4=
<?xml version=”1.0” encoding=”UTF-8”?>
<contact_group>
    <name>New Group from API</name>
    <description>Can I create one from the API</description>
    <contact>https://dot3/ffws/v1/contacts/admin/23</contact>
    <contact>https://dot3/ffws/v1/contacts/admin/24</contact>
    <contact>https://dot3/ffws/v1/contacts/admin/25</contact>
    <contact>https://dot3/ffws/v1/contacts/admin/26</contact>
</contact_group>
----------------------
<?xml version=”1.0” encoding=”UTF-8”?>
<response>
    <message>Created</message>
    <contact_group>
        <contact_group_url>https://dot3/ffws/v1/contact_groups/admin/14</contact_group_url>
        <name>New Group from API</name>
        <description>Can I create one from the API</description>
        <contact>https://dot3/ffws/v1/contacts/admin/23</contact>
        <contact>https://dot3/ffws/v1/contacts/admin/24</contact>
        <contact>https://dot3/ffws/v1/contacts/admin/25</contact>
        <contact>https://dot3/ffws/v1/contacts/admin/26</contact>
    </contact_group>
</response>