---
title: "Update a specific predefined action group"
description: "PUT /predefined_action_groups/{predefined_action_group_id} — Updates a predefined action group. action_ids replaces the group's membership outright rather than adding to it; actions dropped from the list are ungrouped, not deleted."
canonical_url: https://developer.onepagecrm.com/api/reference/predefined-action-groups/put-predefined_action_groups-predefined_action_group_id/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/predefined-action-groups/put-predefined_action_groups-predefined_action_group_id/
---

`PUT /predefined_action_groups/{predefined_action_group_id}`

Updates a predefined action group. action_ids replaces the group's membership outright rather than adding to it; actions dropped from the list are ungrouped, not deleted. Actions already in another group are rejected.

Resource: [Predefined Action Groups](https://developer.onepagecrm.com/api/reference/predefined-action-groups/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X PUT "https://app.onepagecrm.com/api/v3/predefined_action_groups/{predefined_action_group_id}" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Follow-up sequence",
    "position": 0,
    "action_ids": [
      "5acddaa7d556733c507ff405",
      "5acddaa7d556733c507ff406"
    ]
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `predefined_action_group_id` | string | Predefined Action Group ID |

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | string |  | Name of the predefined action group |
| `position` | integer (int32) |  | Position of the group in the list of predefined action groups |
| `action_ids` | array<string (bson-id)> |  | List of IDs of the predefined actions in the predefined action group |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "predefined_action_group": {
      "id": "5c79510e9007ba3f7519e820",
      "text": "Follow-up sequence",
      "position": 0,
      "action_ids": [
        "5acddaa7d556733c507ff405",
        "5acddaa7d556733c507ff406"
      ]
    }
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
- [Partial updates](https://developer.onepagecrm.com/api/partial-updates/)