---
title: "Create a savings goal"
method: PUT
path: "/api/v2/account/{accountUid}/savings-goals"
tags: ["Savings Goals"]
---

# Create a savings goal

`PUT /api/v2/account/{accountUid}/savings-goals`

## Path parameters

- `accountUid` string, uuid, required

## Request body

- SavingsGoalRequestV2 — Request to create a new savings goal
  - `name` string, required — Name of the savings goal
  - `currency` string, required — ISO-4217 3 character currency code of the savings goal
  - `target` CurrencyAndAmount — Representation of money
    - `currency` string, required — ISO-4217 3 character currency code
    - `minorUnits` integer, required — Amount in the minor units of the given currency; eg pence in GBP, cents in EUR
  - `base64EncodedPhoto` string — A text (base 64) encoded picture to associate with the savings goal

## Response `200`

Successful operation

- CreateOrUpdateSavingsGoalResponseV2 — Response after attempting to create a savings goal
  - `savingsGoalUid` string, uuid — Unique identifier of the savings goal
  - `success` boolean — True if the method completed successfully

## Other responses

- `4xx` — Client error. See [API status codes](#api-status-codes-1) for more details.
- `5xx` — Server error. See [API status codes](#api-status-codes-1) for more details.

---

[API](https://skmtc.net/starlingbank/apis/starling-bank-api.md) · [All operations](https://skmtc.net/starlingbank/apis/starling-bank-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starlingbank/starling-bank-api/revisions/fa1a72b9ecec/schema)