Add Bio Link

curl -X POST https://api.bio.re/api/v1/creators/c1a2b3c4-d5e6-7890-abcd-ef1234567890/links \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Watch on YouTube",
    "url": "https://youtube.com/watch?v=dQw4w9WgXcQ"
  }'

type EmbedType = 'YOUTUBE' | 'SPOTIFY' | 'TIKTOK' | 'SOUNDCLOUD' | 'TWITCH' | 'APPLE_MUSIC' | 'CUSTOM';

type CreateBioLinkInput = {
  title: string;
  url: string;
  icon?: string;
  sortOrder?: number;
  active?: boolean;
  embedType?: EmbedType;
  embedMeta?: Record<string, unknown>;
  scheduledStart?: string;
  scheduledEnd?: string;
  isSocial?: boolean;
  platform?: string; // required when isSocial: true
};

async function addBioLink(accessToken: string, creatorId: string, input: CreateBioLinkInput): Promise<string> {
  const res = await fetch(`https://api.bio.re/api/v1/creators/${creatorId}/links`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${accessToken}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  const json = await res.json();
  if (!res.ok || !json.success) {
    throw Object.assign(new Error(json?.error?.message ?? 'Add link failed'), {
      code: json?.error?.code,
      maxLinks: json?.error?.maxLinks, // present on 'creator.links.max_links'
    });
  }
  return json.data.id as string;
}

import { useMutation, useQueryClient } from '@tanstack/react-query';

export function useAddBioLink(creatorId: string) {
  const qc = useQueryClient();
  return useMutation({
    mutationFn: async (input: CreateBioLinkInput) => {
      const res = await fetch(`/api/v1/creators/${creatorId}/links`, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(input),
      });
      const json = await res.json();
      if (!res.ok || !json.success) {
        throw Object.assign(new Error(json?.error?.message ?? 'Add link failed'), {
          code: json?.error?.code,
          i18nKey: json?.error?.i18nKey,
          maxLinks: json?.error?.maxLinks,
        });
      }
      return json.data.id as string;
    },
    onSuccess: () => {
      qc.invalidateQueries({ queryKey: ['creators', creatorId, 'bio'] });
    },
  });
}