/group/create

Description

Create a group.

One Group may contains at most 10000 persons
The app under developer status can  NOT create more than 5 groups.

Parameter

 NameDescription
Required api_key Your registered API Key
  api_secret Your registered API Secret
  group_name Name of the group, which must be unique in one App. Any character except ^@,&=*'" is allowed (quotes for clarification), but the length should not exceed 255.
Optional tag A string to be associated with this group, which does not need to be unique and can be used to store any information. Any character except ^@,&=*'" is allowed, the length must not exceed 255.
  person_id or person_name A comma-separated list of person ids or names, which would be added to the group. Note that a person can be added to multiple groups.

Return Values

FieldTypeDescription
added_person int Number of added person
tag string Tag of the group
group_name string Name of the group
group_id string Id of the group

Parameter

https://apius.faceplusplus.com/v2/group/create?api_key=YOUR_API_KEY&api_secret=YOUR_API_SECRET&tag=created_by_Alice&group_name=Family

JSON Response

{
    "added_person": 0,
    "group_id": "f539fa9f6e4689397c76c57f2cfb4edc", 
    "group_name": "Family",
    "tag": "created_by_Alice"
}

Error Code List

Error CodeHTTP Status CodeError Message
1001 500 INTERNAL_ERROR
1003 403 AUTHORIZATION_ERROR
1003 403 INSUFFICIENT_PRIVILEGE_OR_QUOTA_LIMIT_EXCEEDED
1004 400 MISSING_ARGUMENTS
1008 400 TOO_MANY_ITEMS_TO_ADD
1005 400 INVALID_ARGUMENTS
1006 403 ILLEGAL_USE_OF_DEMO_KEY
1202 502 SERVER_TOO_BUSY
1501 451 BAD_NAME
1502 452 BAD_TAG
1503 453 NAME_EXIST
Google+