API Reference / Contacts

PUT /contacts/{contact_id}/unassign_tag/{tag_name}

Remove a tag from a specific contact

Removes the tag from the contact.

Path parameters

Name Type Description
contact_id req string Contact ID
tag_name req string Tag name

Responses

200 OK
  • statusintegerint32

    Response code

  • messagestring

    Response message

  • timestampintegerunix-timestamp

    Response time

  • dataobject
  • lead_sourcesarray<object>
    array item fields →
    • idstring

      ID of the lead source

    • textstringrequired

      Description of the lead source

    • countsintegerint32

      Number of contacts the (logged API) user owns, with the lead source

    • total_countintegerint32

      Number of contacts the entire team owns, with the lead source

    • action_stream_countintegerint32

      Number of contacts the (logged API) user has actions with, who also have the lead source

    • team_countsarray<object>

      Number of contacts, with the lead source (for each team member)

      array item fields →
      • user_idstringbson-id

        ID of the user

      • countsintegerint32

        Number of contacts the team member owns, with the lead source

  • statusesarray<object>
    array item fields →
    • statusobject

      Values which help qualify where contacts are in the sales pipeline. The list of Statuses is already populated but it may be updated if needed, to better fit your organization.

      object fields →
      • idstringbson-id

        ID of the status

      • statusstring

        Type of the status

        enum: lead · prospect · customer · inactive · general · custom1 · custom2 · customX

      • textstringrequired

        Display text of the status

      • descriptionstring

        Longer description of what the status is for

      • colorstringhex-colorrequired

        The color of the status (six character hex value)

        enum: 666666 · 3399ff · cc0000 · f96600 · 000000 · ff00ff · 009900

      • countsintegerint32

        Number of contacts the (logged API) user owns, with the status

      • total_countintegerint32

        Number of contacts the entire team owns, with the status

      • action_stream_countintegerint32

        Number of contacts the (logged API) user has actions with, who also have the status

      • team_countsarray<object>

        Number of contacts, with the status (for each team member)

        array item fields →
        • user_idstringbson-id

          ID of the user

        • countsintegerint32

          Number of contacts the team member owns, with the status

  • tagsobject
    object fields →
    • tagsarray<object>
      array item fields →
      • namestring

        Name of the tag

      • countsintegerint32

        Number of contacts the (logged API) user owns, with the tag

      • total_countintegerint32

        Number of contacts the entire team owns, with the tag

      • action_stream_countintegerint32

        Number of contacts the (logged API) user has actions with, who also have the tag

    • system_tagsarray<object>
      array item fields →
      • namestring

        Name of the tag

      • countsintegerint32

        Number of contacts the (logged API) user owns, with the tag

      • total_countintegerint32

        Number of contacts the entire team owns, with the tag

      • action_stream_countintegerint32

        Number of contacts the (logged API) user has actions with, who also have the tag

  • contacts_countobject

    Counters showing the number of contacts per letter. The `all` object represents the entire account, while the `users` array contains the same breakdown but per user.

    object fields →
    • allarray<object>

      Counters for the entire account

      array item fields →
      • 1integerint32

        Contacts who's name begins with a non-alphabetic character

      • aintegerint32

        Contacts who's name begins with A

      • bintegerint32

        Contacts who's name begins with B

      • cintegerint32

        Contacts who's name begins with C

      • dintegerint32

        Contacts who's name begins with D

      • eintegerint32

        Contacts who's name begins with E

      • fintegerint32

        Contacts who's name begins with F

      • gintegerint32

        Contacts who's name begins with G

      • hintegerint32

        Contacts who's name begins with H

      • iintegerint32

        Contacts who's name begins with I

      • jintegerint32

        Contacts who's name begins with J

      • kintegerint32

        Contacts who's name begins with K

      • lintegerint32

        Contacts who's name begins with L

      • mintegerint32

        Contacts who's name begins with M

      • nintegerint32

        Contacts who's name begins with N

      • ointegerint32

        Contacts who's name begins with O

      • pintegerint32

        Contacts who's name begins with P

      • qintegerint32

        Contacts who's name begins with Q

      • rintegerint32

        Contacts who's name begins with R

      • sintegerint32

        Contacts who's name begins with S

      • tintegerint32

        Contacts who's name begins with T

      • uintegerint32

        Contacts who's name begins with U

      • vintegerint32

        Contacts who's name begins with V

      • wintegerint32

        Contacts who's name begins with W

      • xintegerint32

        Contacts who's name begins with X

      • yintegerint32

        Contacts who's name begins with Y

      • zintegerint32

        Contacts who's name begins with Z

      • total_countintegerint32
    • usersarray<object>

      Counters per user

      array item fields →
      • 1integerint32

        Contacts who's name begins with a non-alphabetic character

      • aintegerint32

        Contacts who's name begins with A

      • bintegerint32

        Contacts who's name begins with B

      • cintegerint32

        Contacts who's name begins with C

      • dintegerint32

        Contacts who's name begins with D

      • eintegerint32

        Contacts who's name begins with E

      • fintegerint32

        Contacts who's name begins with F

      • gintegerint32

        Contacts who's name begins with G

      • hintegerint32

        Contacts who's name begins with H

      • iintegerint32

        Contacts who's name begins with I

      • jintegerint32

        Contacts who's name begins with J

      • kintegerint32

        Contacts who's name begins with K

      • lintegerint32

        Contacts who's name begins with L

      • mintegerint32

        Contacts who's name begins with M

      • nintegerint32

        Contacts who's name begins with N

      • ointegerint32

        Contacts who's name begins with O

      • pintegerint32

        Contacts who's name begins with P

      • qintegerint32

        Contacts who's name begins with Q

      • rintegerint32

        Contacts who's name begins with R

      • sintegerint32

        Contacts who's name begins with S

      • tintegerint32

        Contacts who's name begins with T

      • uintegerint32

        Contacts who's name begins with U

      • vintegerint32

        Contacts who's name begins with V

      • wintegerint32

        Contacts who's name begins with W

      • xintegerint32

        Contacts who's name begins with X

      • yintegerint32

        Contacts who's name begins with Y

      • zintegerint32

        Contacts who's name begins with Z

      • total_countintegerint32
      • user_idstringbson-id

        ID of the user

  • team_streamobject

    Counters showing the number of entries in the action stream. The `all` object represents the entire account, while the `users` array contains the same breakdown but per user.

    object fields →
    • allintegerint32

      Counters for the entire account (`team_stream`/`action_stream?team=true`)

    • usersarray<object>

      Counters broken down per user (`team_stream?user_id={ID}`)

      array item fields →
      • user_idstringbson-id

        ID of the user

      • countsintegerint32

        The number of entries in the action steam for the user

Standard error responses: 400 · 401 · 403 · 404 · 409 · 500 — shared across the API. See Errors.

Related guides