Contents x
      account.updateCategory
      • 1 Minute to read
      • Print
      • Dark
        Light
      Contents

      account.updateCategory

      • 1 Minute to read
      • Print
      • Dark
        Light
      Article summary

      General Information

      Use this method to update the name of a category. All static segments associated with this category remain.

      Use the account.addCategory method to create a new category.

      Arguments

      Field

      Description

      Field Type

      Required

      Example

      category_id

      The ID number of the category to update. The ID number is returned in the response XML message from the account.addCategory method call. Use the account.getCategories method to retrieve the full set of categories created for your account. You can also find the ID number of a specific category by logging into the application and then navigating to Segmentation > Categories. Mouse over the name of the category that you want and note the URL that appears in your browser's status bar. The category ID number will be the sequence of digits following the final forward slash character. (e.g. http://…/12345).

      number

      Yes

      255475

      category_name

      The new name of the category to be updated. Category names must be unique. Use the account.getCategories method to retrieve the full set of categories created for your account. You can also view existing categories by logging into the application and then navigating to Segmentation > Categories.

      string

      Yes

      Preferred Music Genre

      Response

      Field

      Description

      Example

      responseCode

      A code indicating either the success or failure of the operation. (see Error Codes below)

      122

      responseText

      Human readable description of the response code

      the category has been updated

      category_id

      The ID number of the category being updated.

      255475

      category_name

      The new name of the category as provided in the input XML message.

      Music Preference

      Response Codes

      Error Condition

      responseText

      responseData

      The category name already exists for the account

      121

      action not taken, category name already exists

      Successful operation

      122

      the category has been added

      The category ID either does not exist for the account, or it is not a valid number.

      123

      action not taken, invalid category_id

      Example Post

      <methodCall>
<methodName>account.updateCategory</methodName>
<category_id>255475</category_id>
<category_name>Preferred Music Genre</category_name>
</methodCall>

      Example Response

      <methodResponse>
<item>
<methodName><![CDATA[account.updateCategory]]></methodName>
<responseCode><![CDATA[122]]></responseCode>
<responseText><![CDATA[category has been updated]]></responseText>
<responseData>
<category_id><![CDATA[255475]]></category_id>
<category_name><![CDATA[Preferred Music Genre]]></category_name>
</responseData>
<responseNum><![CDATA[1]]></responseNum>
</item>
</methodResponse>

      Example Error

      <methodResponse>
<item>
<methodName><![CDATA[account.updateCategory]]></methodName>
<responseCode><![CDATA[121]]></responseCode>
<responseText><![CDATA[action not taken, category name already exists]]></responseText>
<responseData>
<category_id><![CDATA[255475]]></category_id>
<category_name><![CDATA[Preferred Music Genre]]></category_name>
</responseData>
<responseNum><![CDATA[1]]></responseNum>
</item>
</methodResponse>

      Was this article helpful?
      What's Next