# Ein ConvertKit-Formular mit React erstellen

> Formspree Docs · Die CLI verwenden · 14. Juli 2023

Lerne, wie du ein React-Formular erstellst, um Abonnenten in deinem [**ConvertKit**](https://convertkit.com/)-Konto anzulegen.

## **1\. Bereite dein Projekt vor**

Installiere die React-Hilfsbibliothek in deinem Projekt:

```
npm install @formspree/react
```

Füge dann den `FormspreeProvider` zu deiner obersten App-Komponente hinzu. Wenn du beispielsweise Next.js verwendest, könnte deine Datei `pages/_app.js` so aussehen:

```jsx
import { FormspreeProvider } from '@formspree/react';
function App({ Component, pageProps }) {
  return (
    <FormspreeProvider project="{your-project-id}">
      <Component {...pageProps} />
    </FormspreeProvider>
  );
}
export default App;
```

## **2\. Konfiguriere dein Formular**

Füge in deiner Datei `formspree.json` ein Opt-in-Formular hinzu. Beachte, dass die von dir angegebenen `tags` bereits in deinem ConvertKit-Konto existieren müssen.

```javascript
{
  "forms": {
    "optInForm": {
      "name": "Opt-In Form",
      "actions": [{ 
        "app": "convertkit", 
        "type": "applyTags",
        "tags": ["Newsletter"]
      }]
    }
  }
}
```

Stelle dann deine Änderungen bei StaticKit bereit:

```
formspree deploy -k <your-deploy-key>
```

Du erhältst Anweisungen, wie du dein ConvertKit-API-Secret speicherst.  
**Erfahre mehr über ConvertKit-Aktionen →**

## **3\. Erstelle dein Formular**

Verbinde deine Formularkomponente mit dem `useForm`-Hook:

```jsx
import React from 'react';
import { useForm, ValidationError } from '@formspree/react';
function OptInForm() {
  const [state, handleSubmit] = useForm("optInForm");
  if (state.succeeded) {
    return <p>Thanks for joining!</p>;
  }
  return (
    <form onSubmit={handleSubmit}>
      <label htmlFor="email">
        Email Address
      </label>
      <input
        id="email"
        type="email" 
        name="email"
      />
      <ValidationError 
        prefix="Email" 
        field="email"
        errors={state.errors} 
      />
      <button type="submit" disabled={state.submitting}>
        Sign Up
      </button>
    </form>
  );
}
export default OptInForm;
```

**[Erfahre mehr über die Formspree CLI](/articles/using-the-cli/the-formspree-cli/) →**  
**[Erfahre mehr über Formspree und React](/articles/working-with-react/the-formspree-react-library/) →**