COcoevera
Contact

ContactSocialRelations.batch_create_or_update

Creates or updates ContactSocialRelation records in one request: an item with an id updates that record, an item without one creates a new record.

post/entities/ContactSocialRelations/batch-modify

Request

Query parameters

validation-levelinteger

Bit mask that relaxes validation on this write. 0 (the default) validates everything. Bits: 2 skip unchanged fields, 4 skip admin-defined validations, 8 allow read-only fields, 16 skip relation checks, 32 skip value checks, 64 skip invalid recalculations, 128 skip step-checklist gates, 256 add conditional field requirements, 512 skip uniqueness checks. Add bits together (20 = 4 + 16); member names and comma lists such as 4,16 work too. A value with an internal-only bit is refused with HTTP 400, code 117.

rollback-method0 | 1

0, the default: one failed item fails the whole batch (HTTP 422, or 404 for an unknown id) and nothing is written. 1: the valid items are written and the call answers 200 with success false and one result per item, an id or an error, in input order. Check every item.

Request body

angellist_urlstring

AngelList profile URL of the contact.

crunchbase_urlstring

Crunchbase profile URL of the contact.

disqus_urlstring

Disqus profile URL of the contact.

facebook_idstring

Facebook profile id of the contact.

facebook_urlstring

Facebook profile URL of the contact.

flickr_urlstring

Flickr profile URL of the contact.

foursquare_urlstring

Foursquare profile URL of the contact.

google_idstring

Google profile id of the contact.

google_plus_urlstring

Google+ profile URL of the contact.

gravatar_urlstring

Gravatar profile URL of the contact.

klout_urlstring

Klout profile URL of the contact.

linkedin_idstring

LinkedIn profile id of the contact.

linkedin_urlstring

LinkedIn profile URL of the contact.

pinterest_urlstring

Pinterest profile URL of the contact.

quora_urlstring

Quora profile URL of the contact.

reddit_urlstring

Reddit profile URL of the contact.

skype_urlstring

Skype contact URL or username of the contact.

slideshare_urlstring

SlideShare profile URL of the contact.

twitter_idstring

Twitter (X) user id of the contact.

twitter_urlstring

Twitter (X) profile URL of the contact.

vimeo_urlstring

Vimeo profile URL of the contact.

wordpress_urlstring

WordPress site URL of the contact.

xing_urlstring

XING profile URL of the contact.

yahoo_urlstring

Yahoo profile URL of the contact.

yelp_urlstring

Yelp profile URL of the contact.

youtube_urlstring

YouTube channel URL of the contact.

revisioninteger

Revision when entity was lastly changed.

idstring uuid

ID of object to update.

Example request

[
  {
    "angellist_url": "string",
    "crunchbase_url": "string",
    "disqus_url": "string",
    "facebook_id": "string",
    "facebook_url": "string",
    "flickr_url": "string",
    "foursquare_url": "string",
    "google_id": "string",
    "google_plus_url": "string",
    "gravatar_url": "string",
    "klout_url": "string",
    "linkedin_id": "string",
    "linkedin_url": "string",
    "pinterest_url": "string",
    "quora_url": "string",
    "reddit_url": "string",
    "skype_url": "string",
    "slideshare_url": "string",
    "twitter_id": "string",
    "twitter_url": "string",
    "vimeo_url": "string",
    "wordpress_url": "string",
    "xing_url": "string",
    "yahoo_url": "string",
    "yelp_url": "string",
    "youtube_url": "string",
    "revision": 1
  }
]

Response

Result per item, in request order: the id of the created or updated record, or the error.

successboolean

True when the request succeeded; false on error.

Example response

{
  "success": true,
  "data": [
    {
      "http_status": 400,
      "code": 117,
      "name": "ERROR_PARAMETER_INVALID"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.