Create or update a Google Ads audience segment

http
PUT https://services.leadconnectorhq.com/ad-publishing/google/segments

Authorization

NameTypeRequiredExampleDescription
AuthorizationstringYesBearer token generated from the Leadway portal. See Authentication.
VersionstringYes2021-07-28API version.

Query parameters

NameTypeRequiredExampleDescription
locationIdstringYesHChooFuiyPpVYzeJ4HMeAccount identifier
typestringYesCUSTOM_SEGMENTSSegment type

Body

NameTypeRequiredExampleDescription
namestringYesMy SegmentSegment name
descriptionstringNoTarget audience segmentSegment description
  • members (object[]): Segment members — keywords, URLs, or apps that define the custom segment

    • memberType (string, required): Member type Possible values: 'KEYWORD', 'URL', 'APP' Example: KEYWORD

    • keyword (string): Keyword value Example: marketing

    • url (string): URL value Example: https://example.com

    • app (string): App identifier Example: com.example.app

NameTypeRequiredExampleDescription
statusstringNoENABLEDSegment status
typestringNoCUSTOM_SEGMENTSSegment type
idstringNoseg_123Segment identifier
membershipStatusstringNoOPENMembership status
ruleBasedUserListobjectNoRule-based user list config
membershipLifeSpannumberNo30Membership life span
seedUserListIdsstring[]NoSeed user list IDs
countryCodesstring[]NoCountry codes
expansionLevelstringNoBALANCEDExpansion level Possible values: 'BALANCED', 'BROAD', 'NARROW'

Responses

200 - Response
400 - Bad Request
json
{}
401 - Unauthorized
json
{}
422 - Unprocessable Entity
json
{}

Example

curl -X PUT 'https://services.leadconnectorhq.com/ad-publishing/google/segments' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "My Segment",
  "description": "Target audience segment",
  "members": [
    {
      "memberType": "KEYWORD",
      "keyword": "digital marketing"
    },
    {
      "memberType": "URL",
      "url": "https://example.com"
    },
    {
      "memberType": "APP",
      "app": "com.example.app"
    }
  ],
  "status": "ENABLED",
  "type": "CUSTOM_SEGMENTS",
  "id": "seg_123",
  "membershipStatus": "OPEN",
  "membershipLifeSpan": 30,
  "seedUserListIds": [
    "list_1"
  ],
  "countryCodes": [
    "US",
    "CA"
  ],
  "expansionLevel": "BALANCED"
}'

Last updated October 26, 2026

Was this page helpful?