## Update an account

`client.Embed.Accounts.Update(ctx, accountID, params) (*AccountV1, error)`

**put** `/v1/accounts/{account_id}`

Updates an existing account's information. This endpoint allows you to update various account details during onboarding or after the account has been created.

### Parameters

- `accountID string`

- `params EmbedAccountUpdateParams`

  - `BusinessProfile param.Field[BusinessProfileV1]`

    Body param

  - `ExternalID param.Field[string]`

    Body param: Unique identifier for the account in your database, used for cross-referencing between Straddle and your systems.

  - `Metadata param.Field[map[string, string]]`

    Body param: Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the account in a structured format.

  - `CorrelationID param.Field[string]`

    Header param: Optional client generated identifier to trace and debug a series of requests.

  - `IdempotencyKey param.Field[string]`

    Header param: Optional client generated value to use for idempotent requests.

  - `RequestID param.Field[string]`

    Header param: Optional client generated identifier to trace and debug a request.

### Returns

- `type AccountV1 struct{…}`

  - `Data AccountV1Data`

    - `ID string`

      Unique identifier for the account.

    - `AccessLevel string`

      The access level granted to the account. This is determined by your platform configuration. Use `standard` unless instructed otherwise by Straddle.

      - `const AccountV1DataAccessLevelStandard AccountV1DataAccessLevel = "standard"`

      - `const AccountV1DataAccessLevelManaged AccountV1DataAccessLevel = "managed"`

    - `OrganizationID string`

      The unique identifier of the organization this account belongs to.

    - `Status string`

      The current status of the account (e.g., 'active', 'inactive', 'pending').

      - `const AccountV1DataStatusCreated AccountV1DataStatus = "created"`

      - `const AccountV1DataStatusOnboarding AccountV1DataStatus = "onboarding"`

      - `const AccountV1DataStatusActive AccountV1DataStatus = "active"`

      - `const AccountV1DataStatusRejected AccountV1DataStatus = "rejected"`

      - `const AccountV1DataStatusInactive AccountV1DataStatus = "inactive"`

    - `StatusDetail AccountV1DataStatusDetail`

      - `Code string`

        A machine-readable code for the specific status, useful for programmatic handling.

      - `Message string`

        A human-readable message describing the current status.

      - `Reason string`

        A machine-readable identifier for the specific status, useful for programmatic handling.

        - `const AccountV1DataStatusDetailReasonUnverified AccountV1DataStatusDetailReason = "unverified"`

        - `const AccountV1DataStatusDetailReasonInReview AccountV1DataStatusDetailReason = "in_review"`

        - `const AccountV1DataStatusDetailReasonPending AccountV1DataStatusDetailReason = "pending"`

        - `const AccountV1DataStatusDetailReasonStuck AccountV1DataStatusDetailReason = "stuck"`

        - `const AccountV1DataStatusDetailReasonVerified AccountV1DataStatusDetailReason = "verified"`

        - `const AccountV1DataStatusDetailReasonFailedVerification AccountV1DataStatusDetailReason = "failed_verification"`

        - `const AccountV1DataStatusDetailReasonDisabled AccountV1DataStatusDetailReason = "disabled"`

        - `const AccountV1DataStatusDetailReasonTerminated AccountV1DataStatusDetailReason = "terminated"`

        - `const AccountV1DataStatusDetailReasonNew AccountV1DataStatusDetailReason = "new"`

      - `Source string`

        Identifies the origin of the status change (e.g., `bank_decline`, `watchtower`). This helps in tracking the cause of status updates.

        - `const AccountV1DataStatusDetailSourceWatchtower AccountV1DataStatusDetailSource = "watchtower"`

    - `Type string`

      The type of account (e.g., 'individual', 'business').

      - `const AccountV1DataTypeBusiness AccountV1DataType = "business"`

    - `BusinessProfile BusinessProfileV1`

      - `Name string`

        The operating or trade name of the business.

      - `Website string`

        URL of the business's primary marketing website.

      - `Address AddressV1`

        The address object is optional. If provided, it must be a valid address.

        - `City string`

          City, district, suburb, town, or village.

        - `Line1 string`

          Primary address line (e.g., street, PO Box).

        - `PostalCode string`

          Postal or ZIP code.

        - `State string`

          Two-letter state code.

        - `Country string`

          The country of the address, in ISO 3166-1 alpha-2 format.

        - `Line2 string`

          Secondary address line (e.g., apartment, suite, unit, or building).

      - `Description string`

        A brief description of the business and its products or services.

      - `Industry IndustryV1`

        - `Category string`

          The general category of the industry. Required if not providing MCC.

        - `Mcc string`

          The Merchant Category Code (MCC) that best describes the business. Optional.

        - `Sector string`

          The specific sector within the industry category. Required if not providing MCC.

      - `LegalName string`

        The official registered name of the business.

      - `Phone string`

        The primary contact phone number for the business.

      - `SupportChannels SupportChannelsV1`

        - `Email string`

          The email address for customer support inquiries.

        - `Phone string`

          The phone number for customer support.

        - `URL string`

          The URL of the business's customer support page or contact form.

      - `TaxID string`

        The business's tax identification number (e.g., EIN in the US).

      - `UseCase string`

        A description of how the business intends to use Straddle's services.

    - `Capabilities AccountV1DataCapabilities`

      - `ConsentTypes AccountV1DataCapabilitiesConsentTypes`

        - `Internet CapabilityV1`

          Whether the internet payment authorization capability is enabled for the account.

          - `CapabilityStatus CapabilityV1CapabilityStatus`

            - `const CapabilityV1CapabilityStatusActive CapabilityV1CapabilityStatus = "active"`

            - `const CapabilityV1CapabilityStatusInactive CapabilityV1CapabilityStatus = "inactive"`

        - `SignedAgreement CapabilityV1`

          Whether the signed agreement payment authorization capability is enabled for the account.

      - `CustomerTypes AccountV1DataCapabilitiesCustomerTypes`

        - `Businesses CapabilityV1`

        - `Individuals CapabilityV1`

      - `PaymentTypes AccountV1DataCapabilitiesPaymentTypes`

        - `Charges CapabilityV1`

        - `Payouts CapabilityV1`

    - `CreatedAt Time`

      Timestamp of when the account was created.

    - `ExternalID string`

      Unique identifier for the account in your database, used for cross-referencing between Straddle and your systems.

    - `Metadata map[string, string]`

      Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the account in a structured format.

    - `Settings AccountV1DataSettings`

      - `Charges AccountV1DataSettingsCharges`

        - `DailyAmount int64`

          The maximum dollar amount of charges in a calendar day.

        - `FundingTime string`

          The amount of time it takes for a charge to be funded. This value is defined by Straddle.

          - `const AccountV1DataSettingsChargesFundingTimeImmediate AccountV1DataSettingsChargesFundingTime = "immediate"`

          - `const AccountV1DataSettingsChargesFundingTimeNextDay AccountV1DataSettingsChargesFundingTime = "next_day"`

          - `const AccountV1DataSettingsChargesFundingTimeOneDay AccountV1DataSettingsChargesFundingTime = "one_day"`

          - `const AccountV1DataSettingsChargesFundingTimeTwoDay AccountV1DataSettingsChargesFundingTime = "two_day"`

          - `const AccountV1DataSettingsChargesFundingTimeThreeDay AccountV1DataSettingsChargesFundingTime = "three_day"`

          - `const AccountV1DataSettingsChargesFundingTimeFourDay AccountV1DataSettingsChargesFundingTime = "four_day"`

          - `const AccountV1DataSettingsChargesFundingTimeFiveDay AccountV1DataSettingsChargesFundingTime = "five_day"`

        - `LinkedBankAccountID string`

          The unique identifier of the linked bank account associated with charges. This value is defined by Straddle.

        - `MaxAmount int64`

          The maximum amount of a single charge.

        - `MonthlyAmount int64`

          The maximum dollar amount of charges in a calendar month.

        - `MonthlyCount int64`

          The maximum number of charges in a calendar month.

      - `Payouts AccountV1DataSettingsPayouts`

        - `DailyAmount int64`

          The maximum dollar amount of payouts in a day.

        - `FundingTime string`

          The amount of time it takes for a payout to be funded. This value is defined by Straddle.

          - `const AccountV1DataSettingsPayoutsFundingTimeImmediate AccountV1DataSettingsPayoutsFundingTime = "immediate"`

          - `const AccountV1DataSettingsPayoutsFundingTimeNextDay AccountV1DataSettingsPayoutsFundingTime = "next_day"`

          - `const AccountV1DataSettingsPayoutsFundingTimeOneDay AccountV1DataSettingsPayoutsFundingTime = "one_day"`

          - `const AccountV1DataSettingsPayoutsFundingTimeTwoDay AccountV1DataSettingsPayoutsFundingTime = "two_day"`

          - `const AccountV1DataSettingsPayoutsFundingTimeThreeDay AccountV1DataSettingsPayoutsFundingTime = "three_day"`

          - `const AccountV1DataSettingsPayoutsFundingTimeFourDay AccountV1DataSettingsPayoutsFundingTime = "four_day"`

          - `const AccountV1DataSettingsPayoutsFundingTimeFiveDay AccountV1DataSettingsPayoutsFundingTime = "five_day"`

        - `LinkedBankAccountID string`

          The unique identifier of the linked bank account to use for payouts.

        - `MaxAmount int64`

          The maximum amount of a single payout.

        - `MonthlyAmount int64`

          The maximum dollar amount of payouts in a month.

        - `MonthlyCount int64`

          The maximum number of payouts in a month.

    - `TermsOfService TermsOfServiceV1`

      - `AcceptedDate Time`

        The datetime of when the terms of service were accepted, in ISO 8601 format.

      - `AgreementType TermsOfServiceV1AgreementType`

        The type or version of the agreement accepted. Use `embedded` unless your platform was specifically enabled for `direct` agreements.

        - `const TermsOfServiceV1AgreementTypeEmbedded TermsOfServiceV1AgreementType = "embedded"`

        - `const TermsOfServiceV1AgreementTypeDirect TermsOfServiceV1AgreementType = "direct"`

      - `AgreementURL string`

        The URL where the full text of the accepted agreement can be found.

      - `AcceptedIP string`

        The IP address from which the terms of service were accepted.

      - `AcceptedUserAgent string`

        The user agent string of the browser or application used to accept the terms.

    - `UpdatedAt Time`

      Timestamp of the most recent update to the account.

  - `Meta ResponseMetadata`

    Metadata about the API request, including an identifier and timestamp.

    - `APIRequestID string`

      Unique identifier for this API request, useful for troubleshooting.

    - `APIRequestTimestamp Time`

      Timestamp for this API request, useful for troubleshooting.

  - `ResponseType AccountV1ResponseType`

    Indicates the structure of the returned content.

    - "object" means the `data` field contains a single JSON object.
    - "array" means the `data` field contains an array of objects.
    - "error" means the `data` field contains an error object with details of the issue.
    - "none" means no data is returned.

    - `const AccountV1ResponseTypeObject AccountV1ResponseType = "object"`

    - `const AccountV1ResponseTypeArray AccountV1ResponseType = "array"`

    - `const AccountV1ResponseTypeError AccountV1ResponseType = "error"`

    - `const AccountV1ResponseTypeNone AccountV1ResponseType = "none"`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/straddleio/straddle-go"
  "github.com/straddleio/straddle-go/option"
)

func main() {
  client := straddle.NewClient(
    option.WithAPIKey("My API Key"),
  )
  accountV1, err := client.Embed.Accounts.Update(
    context.TODO(),
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    straddle.EmbedAccountUpdateParams{
      BusinessProfile: straddle.BusinessProfileV1Param{
        Name: "name",
        Website: "https://example.com",
      },
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", accountV1.Data)
}
```

#### Response

```json
{
  "data": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "access_level": "standard",
    "organization_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "status": "created",
    "status_detail": {
      "code": "code",
      "message": "message",
      "reason": "unverified",
      "source": "watchtower"
    },
    "type": "business",
    "business_profile": {
      "name": "name",
      "website": "https://example.com",
      "address": {
        "city": "city",
        "line1": "line1",
        "postal_code": "21029-1360",
        "state": "SE",
        "country": "country",
        "line2": "line2"
      },
      "description": "description",
      "industry": {
        "category": "category",
        "mcc": "mcc",
        "sector": "sector"
      },
      "legal_name": "legal_name",
      "phone": "+46991022",
      "support_channels": {
        "email": "dev@stainless.com",
        "phone": "+46991022",
        "url": "https://example.com"
      },
      "tax_id": "210297980",
      "use_case": "use_case"
    },
    "capabilities": {
      "consent_types": {
        "internet": {
          "capability_status": "active"
        },
        "signed_agreement": {
          "capability_status": "active"
        }
      },
      "customer_types": {
        "businesses": {
          "capability_status": "active"
        },
        "individuals": {
          "capability_status": "active"
        }
      },
      "payment_types": {
        "charges": {
          "capability_status": "active"
        },
        "payouts": {
          "capability_status": "active"
        }
      }
    },
    "created_at": "2019-12-27T18:11:19.117Z",
    "external_id": "external_id",
    "metadata": {
      "foo": "string"
    },
    "settings": {
      "charges": {
        "daily_amount": 0,
        "funding_time": "immediate",
        "linked_bank_account_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "max_amount": 0,
        "monthly_amount": 0,
        "monthly_count": 0
      },
      "payouts": {
        "daily_amount": 0,
        "funding_time": "immediate",
        "linked_bank_account_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "max_amount": 0,
        "monthly_amount": 0,
        "monthly_count": 0
      }
    },
    "terms_of_service": {
      "accepted_date": "2019-12-27T18:11:19.117Z",
      "agreement_type": "embedded",
      "agreement_url": "agreement_url",
      "accepted_ip": "accepted_ip",
      "accepted_user_agent": "accepted_user_agent"
    },
    "updated_at": "2019-12-27T18:11:19.117Z"
  },
  "meta": {
    "api_request_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "api_request_timestamp": "2019-12-27T18:11:19.117Z"
  },
  "response_type": "object"
}
```